WSANAMESPACE_INFOEXA 結構 (winsock2.h)

  • 發行項

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

語法

typedef struct _WSANAMESPACE_INFOEXA {
  GUID  NSProviderId;
  DWORD dwNameSpace;
  BOOL  fActive;
  DWORD dwVersion;
  LPSTR lpszIdentifier;
  BLOB  ProviderSpecific;
} WSANAMESPACE_INFOEXA, *PWSANAMESPACE_INFOEXA, *LPWSANAMESPACE_INFOEXA;

成員

NSProviderId

類型： GUID

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

dwNameSpace

類型： DWORD

此提供者支援的命名空間。

dwNameSpace 成員的可能值列在 Winsock2.h 包含檔案中。 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 結構包含與 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

另請參閱

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32