WSANAMESPACE_INFOEXW 結構 (winsock2.h)
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 包含檔案中。 Windows Vista 和更新版本包含數個命名空間提供者。 您可以安裝其他命名空間提供者,因此只有下列可能的值才可供使用。 可能有許多其他值。
fActive
類型: BOOL
如果 為TRUE,表示此命名空間提供者為作用中。 如果 為 FALSE,則命名空間提供者為非作用中,而且無法供查詢存取,即使查詢特別參考此命名空間提供者也一樣。
dwVersion
類型: DWORD
命名空間提供者的版本號碼。
lpszIdentifier
類型: LPTSTR
識別命名空間提供者的顯示字串。
ProviderSpecific
類型: BLOB
與命名空間項目相關聯的提供者特定數據 Blob。
備註
WSANAMESPACE_INFOEX 結構是 WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函式用來傳回可用命名空間提供者資訊的增強版WSANAMESPACE_INFO結構。 WSANAMESPACE_INFOEX 結構包含與 lpProviderInfo 參數中傳遞至 WSCInstallNameSpaceEx 和 WSCInstallNameSpaceEx32 函式之命名空間專案相關聯的提供者特定數據 Blob。
目前,Windows 隨附的唯一命名空間會使用WSANAMESPACE_INFOEX結構 ProviderSpecific 成員中的資訊,是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 |