Fungsi DsGetSiteNameW (dsgetdc.h)

Artikel
11/20/2024

Fungsi DsGetSiteName mengembalikan nama situs tempat komputer berada. Untuk pengendali domain (DC), nama situs adalah lokasi DC yang dikonfigurasi. Untuk stasiun kerja anggota atau server anggota, nama menentukan situs stasiun kerja seperti yang dikonfigurasi di domain komputer.

Sintaksis

DSGETDCAPI DWORD DsGetSiteNameW(
  [in]  LPCWSTR ComputerName,
  [out] LPWSTR  *SiteName
);

Parameter

[in] ComputerName

Penunjuk ke string null-terminated yang menentukan nama server untuk mengirim fungsi ini. NULL menyiratkan komputer lokal.

[out] SiteName

Penunjuk ke variabel yang menerima penunjuk ke string null-terminated yang menentukan lokasi situs komputer ini. String ini dialokasikan oleh sistem dan harus dibebaskan menggunakan fungsi NetApiBufferFree.

Mengembalikan nilai

Jika fungsi mengembalikan informasi akun, nilai pengembalian NO_ERROR.

Jika fungsi gagal, nilai pengembalian dapat menjadi salah satu kode kesalahan berikut.

Komentar

Fungsi DsGetSiteName tidak memerlukan akses tertentu ke domain yang ditentukan. Fungsi ini dikirim ke layanan "NetLogon" di komputer yang ditentukan oleh ComputerName.

Nota

Header dsgetdc.h mendefinisikan DsGetSiteName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	dsgetdc.h
Pustaka	Netapi32.lib
DLL	Netapi32.dll

Lihat juga

Directory Service Functions

DsGetDcName

DsValidateSubnetName

NetApiBufferFree

Bagikan melalui