WSANAMESPACE_INFOA結構 (winsock2.h)

發行項
08/27/2023

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

語法

typedef struct _WSANAMESPACE_INFOA {
  GUID  NSProviderId;
  DWORD dwNameSpace;
  BOOL  fActive;
  DWORD dwVersion;
  LPSTR lpszIdentifier;
} WSANAMESPACE_INFOA, *PWSANAMESPACE_INFOA, *LPWSANAMESPACE_INFOA;

成員

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

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

備註

WSAEnumNameSpaceProviders和WSCEnumNameSpaceProviders32函式會使用WSANAMESPACE_INFO結構來傳回可用命名空間提供者的相關資訊。 WSANAMESPACE_INFO結構包含安裝命名空間提供者時傳遞至WSCInstallNameSpace 和 WSCInstallNameSpace32函式之命名空間專案的提供者特定資訊。

定義 UNICODE 或_UNICODE時， WSANAMESPACE_INFO 定義為 WSANAMESPACE_INFOW，此資料結構的 Unicode 版本和 lpszIdentifier 字串成員會定義為 LPWSTR 資料類型。

未定義 UNICODE 或_UNICODE時， 會將WSANAMESPACE_INFO 定義為 WSANAMESPACE_INFOA，此資料結構的 ANSI 版本，而 lpszIdentifier 字串成員會定義為 LPSTR 資料類型。

在 Windows Vista 和更新版本上，WSANAMESPACE_INFOEX，WSANAMESPACE_INFO結構的增強版本，會由呼叫WSAEnumNameSpaceProvidersEx和WSCEnumNameSpaceProvidersEx32函式傳回

注意

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

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winsock2.h