struktur WSANAMESPACE_INFOEXW (winsock2.h)

Artikel
08/27/2023

Struktur WSANAMESPACE_INFOEX berisi semua informasi pendaftaran untuk penyedia namespace.

Sintaks

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

Anggota

NSProviderId

Jenis: GUID

GUID unik untuk penyedia namespace layanan ini.

dwNameSpace

Jenis: DWORD

Namespace layanan yang didukung oleh penyedia ini.

Nilai yang mungkin untuk anggota dwNameSpace tercantum dalam file Winsock2.h include. 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 layanan 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 serekan 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 layanan ini.

dwVersion

Jenis: DWORD

Nomor versi penyedia namespace layanan.

lpszIdentifier

Jenis: LPTSTR

String tampilan yang mengidentifikasi penyedia namespace.

ProviderSpecific

Jenis: BLOB

Blob data khusus penyedia yang terkait dengan entri namespace.

Keterangan

Struktur WSANAMESPACE_INFOEX adalah versi yang disempurnakan dari struktur WSANAMESPACE_INFO yang digunakan oleh fungsi WSAEnumNameSpaceProvidersEx dan WSCEnumNameSpaceProvidersEx32 untuk mengembalikan informasi tentang penyedia namespace yang tersedia. Struktur WSANAMESPACE_INFOEX berisi blob data khusus penyedia yang terkait dengan entri namespace yang diteruskan dalam parameter lpProviderInfo ke fungsi WSCInstallNameSpaceEx dan WSCInstallNameSpaceEx32 .

Saat ini, satu-satunya namespace yang disertakan dengan Windows yang menggunakan informasi di anggota ProviderSpecific struktur WSANAMESPACE_INFOEX adalah penyedia namespace layanan untuk namespace layanan NS_EMAIL. Format anggota ProviderSpecific untuk penyedia namespace NS_EMAIL adalah struktur NAPI_PROVIDER_INSTALLATION_BLOB .

Ketika UNICODE atau _UNICODE didefinisikan, WSANAMESPACE_INFOEX didefinisikan untuk WSANAMESPACE_INFOEXW, versi Unicode dari struktur ini dan anggota string lpszIdentifier didefinisikan ke jenis data LPWSTR .

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

Fungsi WSCEnumNameSpaceProvidersEx32 adalah fungsi khusus Unicode dan mengembalikan struktur WSANAMESPACE_INFOEXW .

Catatan

Header winsock2.h mendefinisikan WSANAMESPACE_INFOEX 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 Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	winsock2.h