struktur WSANAMESPACE_INFOW (winsock2.h)

Artikel
03/13/2024

Struktur WSANAMESPACE_INFO berisi semua informasi pendaftaran untuk penyedia namespace.

Sintaks

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

Anggota

NSProviderId

Jenis: GUID

GUID unik untuk penyedia namespace ini.

dwNameSpace

Jenis: DWORD

Namespace layanan yang didukung oleh penyedia ini.

Nilai yang mungkin untuk anggota dwNameSpace tercantum dalam file sertakan Winsock2.h . Beberapa penyedia namespace disertakan dengan Windows Vista dan yang lebih baru. Penyedia namespace layanan lain dapat diinstal, sehingga nilai yang mungkin berikut ini hanyalah yang umumnya tersedia. Banyak nilai lain yang dimungkinkan.

Nilai	Makna
NS_BTH	Namespace Bluetooth. Pengidentifikasi namespace ini didukung pada Windows Vista dan yang lebih baru.
NS_DNS	Namespace sistem nama domain (DNS).
NS_EMAIL	Namespace email. Pengidentifikasi namespace ini didukung pada Windows Vista dan yang lebih baru.
NS_NLA	Namespace layanan kesadaran lokasi jaringan (NLA). Pengidentifikasi namespace ini didukung pada Windows XP dan yang lebih baru.
NS_NTDS	Namespace layanan direktori Windows NT (NTDS).
NS_PNRPNAME	Ruang nama peer-to-peer untuk nama peer tertentu. Pengidentifikasi namespace ini didukung pada Windows Vista dan yang lebih baru.
NS_PNRPCLOUD	Ruang nama peer-to-peer untuk kumpulan nama serekan. Pengidentifikasi namespace ini didukung pada Windows Vista dan yang lebih baru.

fActive

Jenis: BOOL

Jika TRUE, menunjukkan bahwa penyedia namespace ini aktif. Jika FALSE, penyedia namespace tidak aktif dan tidak dapat diakses untuk kueri, bahkan jika kueri secara khusus mereferensikan penyedia namespace ini.

dwVersion

Jenis: DWORD

Nomor versi penyedia namespace layanan.

lpszIdentifier

Jenis: LPTSTR

String tampilan yang mengidentifikasi penyedia namespace.

Keterangan

Struktur WSANAMESPACE_INFO digunakan oleh fungsi WSAEnumNameSpaceProviders dan WSCEnumNameSpaceProviders32 untuk mengembalikan informasi tentang penyedia namespace yang tersedia. Struktur WSANAMESPACE_INFO berisi informasi khusus penyedia pada entri namespace yang diteruskan ke fungsi WSCInstallNameSpace dan WSCInstallNameSpace32 saat penyedia namespace diinstal.

Ketika UNICODE atau _UNICODE ditentukan, WSANAMESPACE_INFO didefinisikan ke WSANAMESPACE_INFOW, versi Unicode dari struktur data ini dan anggota string lpszIdentifier didefinisikan ke jenis data LPWSTR .

Ketika UNICODE atau _UNICODE tidak ditentukan, WSANAMESPACE_INFO didefinisikan untuk WSANAMESPACE_INFOA, versi ANSI dari struktur data ini dan anggota string lpszIdentifier didefinisikan ke jenis data LPSTR .

Pada Windows Vista dan yang lebih baru, WSANAMESPACE_INFOEX, versi struktur WSANAMESPACE_INFO yang disempurnakan, dikembalikan oleh panggilan ke fungsi WSAEnumNameSpaceProvidersEx dan WSCEnumNameSpaceProvidersEx32

Catatan

Header winsock2.h mendefinisikan WSANAMESPACE_INFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winsock2.h