WSANAMESPACE_INFOEXW結構（winsock2.h）

發行項
11/20/2024

WSANAMESPACE_INFOEX 結構包含命名空間提供者的所有註冊資訊。

語法

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

成員

NSProviderId

類型：GUID

這個命名空間提供者的唯一 GUID。

dwNameSpace

類型：DWORD

這個提供者支援的命名空間。

dwNameSpace 成員的可能值列在 Winsock2.h include 檔案中。 Windows Vista 和更新版本包含數個命名空間提供者。可以安裝其他命名空間提供者，因此下列可能的值只是那些常用的值。其他許多值都是可能的。

價值	意義
NS_BTH	藍牙命名空間。 Windows Vista 和更新版本支援此命名空間標識碼。
NS_DNS	功能變數名稱系統（DNS）命名空間。
NS_EMAIL	電子郵件命名空間。 Windows Vista 和更新版本支援此命名空間標識碼。
NS_NLA	網路位置感知（NLA）命名空間。 Windows XP 和更新版本支援此命名空間識別碼。
NS_NTDS	Windows NT 目錄服務（NTDS）命名空間。
NS_PNRPNAME	特定對等名稱的點對點名稱空間。 Windows Vista 和更新版本支援此命名空間標識碼。
NS_PNRPCLOUD	對等名稱集合的點對點名稱空間。 Windows Vista 和更新版本支援此命名空間標識碼。

fActive

類型：BOOL

如果 TRUE，表示此命名空間提供者為使用中。如果 FALSE，則命名空間提供者為非使用中，而且無法供查詢存取，即使查詢特別參考此命名空間提供者也一樣。

dwVersion

類型：DWORD

命名空間提供者的版本號碼。

lpszIdentifier

類型：LPTSTR

識別命名空間提供者的顯示字串。

ProviderSpecific

類型：BLOB

與命名空間項目相關聯的提供者特定數據 Blob。

言論

WSANAMESPACE_INFOEX 結構是 WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函式用來傳回可用命名空間提供者資訊的增強版 WSANAMESPACE_INFO 結構。 WSANAMESPACE_INFOEX 結構包含與傳遞至 WSC InstallNameSpaceEx 和 WSCInstallNameSpaceEx32 函式之命名空間專案相關聯的提供者特定數據 Blob。

目前，在 WSANAMESPACE_INFOEX 結構之 ProviderSpecific 成員中使用資訊之 Windows 隨附的唯一命名空間是NS_EMAIL命名空間的命名空間提供者。 NS_EMAIL命名空間提供者 ProviderSpecific 成員的格式是 NAPI_PROVIDER_INSTALLATION_BLOB 結構。

定義 UNICODE 或_UNICODE時，WSANAMESPACE_INFOEX 定義為 WSANAMESPACE_INFOEXW，這個結構的 Unicode 版本和 lpszIdentifier 字串成員會定義至 LPWSTR 資料類型。

未定義 UNICODE 或_UNICODE時，WSANAMESPACE_INFOEX 定義為 WSANAMESPACE_INFOEXA，此結構的 ANSI 版本和 lpszIdentifier 字串成員會定義至 LPSTR 數據類型。

WSCEnumNameSpaceProvidersEx32 函式是唯一的 Unicode 函式，並傳回 WSANAMESPACE_INFOEXW 結構。

注意

winsock2.h 標頭會將 WSANAMESPACE_INFOEX 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	winsock2.h