WSAQUERYSET2A結構 (winsock2.h)

  • 發行項

WSAQUERYSET2結構提供指定服務的相關資訊，包括服務類別識別碼、服務名稱、適用的命名空間識別碼和通訊協定資訊，以及服務接聽的一組傳輸位址。

語法

typedef struct _WSAQuerySet2A {
  DWORD         dwSize;
  LPSTR         lpszServiceInstanceName;
  LPWSAVERSION  lpVersion;
  LPSTR         lpszComment;
  DWORD         dwNameSpace;
  LPGUID        lpNSProviderId;
  LPSTR         lpszContext;
  DWORD         dwNumberOfProtocols;
  LPAFPROTOCOLS lpafpProtocols;
  LPSTR         lpszQueryString;
  DWORD         dwNumberOfCsAddrs;
  LPCSADDR_INFO lpcsaBuffer;
  DWORD         dwOutputFlags;
  LPBLOB        lpBlob;
} WSAQUERYSET2A, *PWSAQUERYSET2A, *LPWSAQUERYSET2A;

成員

dwSize

類型： DWORD

WSAQUERYSET2 結構的大小 ，以位元組為單位。 此成員會作為版本控制機制，因為 WSAQUERYSET2 結構的大小可能會在更新版本的 Windows 上變更。

lpszServiceInstanceName

類型： LPTSTR

包含服務名稱的選擇性 Null終止字串指標。 未定義字串內使用萬用字元的語意，但可由特定命名空間提供者支援。

lpVersion

類型： LPWSAVERSION

命名空間提供者選擇性所需版本號碼的指標。 此成員提供版本比較語意 (，也就是所要求的版本必須完全相符，或版本不得小於) 提供的值。

lpszComment

類型： LPTSTR

查詢會忽略這個成員。

dwNameSpace

類型： DWORD

命名空間識別碼，決定要查詢哪些命名空間提供者。 傳遞特定命名空間識別碼只會產生支援所查詢指定命名空間的命名空間提供者。 指定 NS_ALL 會導致查詢所有已安裝和作用中的命名空間提供者。

dwNameSpace成員的選項會列在Winsock2.h包含檔案中。 Windows Vista 和更新版本包含數個新的命名空間提供者。 您可以安裝其他命名空間提供者，因此只有下列可能的值才可供使用。 可能有許多其他值。

值 意義
NS_ALL
 所有已安裝和作用中的命名空間。
NS_BTH
 藍牙命名空間。 Windows Vista 和更新版本支援此命名空間識別碼。
NS_DNS
 網域名稱系統 (DNS) 命名空間。
NS_EMAIL
 電子郵件命名空間。 Windows Vista 和更新版本支援此命名空間識別碼。
NS_NLA
 網路位置感知 (NLA) 命名空間。 Windows XP 和更新版本支援此命名空間識別碼。
NS_PNRPNAME
 特定對等名稱的點對點名稱空間。 Windows Vista 和更新版本支援此命名空間識別碼。
NS_PNRPCLOUD
 對等名稱集合的對等名稱空間。 Windows Vista 和更新版本支援此命名空間識別碼。

lpNSProviderId

類型： LPGUID

特定命名空間提供者選擇性 GUID 的指標，可在多個命名空間提供者登錄于單一命名空間下，例如 NS_DNS。 傳遞特定命名空間提供者的 GUID 將只會查詢指定的命名空間提供者。 您可以呼叫 WSAEnumNameSpaceProviders 和 WSAEnumNameSpaceProvidersEx 函式來擷取命名空間提供者的 GUID。

lpszContext

類型： LPTSTR

階層命名空間中查詢的選擇性起點指標。

dwNumberOfProtocols

類型： DWORD

通訊協定條件約束陣列的大小，以位元組為單位。 這個成員可以是零。

lpafpProtocols

類型： LPAFPROTOCOLS

AFPROTOCOLS結構的選擇性陣列指標。 只會傳回使用這些通訊協定的服務。

lpszQueryString

類型： LPTSTR

選擇性 Null終止查詢字串的指標。 某些命名空間，例如 Whois++，支援擴充的類似 SQL 的查詢，這些查詢包含在簡單的文字字串中。 此參數是用來指定該字串。

dwNumberOfCsAddrs

類型： DWORD

查詢會忽略這個成員。

lpcsaBuffer

類型： LPCSADDR_INFO

查詢會忽略這個成員。

dwOutputFlags

類型： DWORD

查詢會忽略這個成員。

lpBlob

類型： LPBLOB

用來查詢或設定提供者特定命名空間資訊的選擇性資料指標。 此資訊的格式專屬於命名空間提供者。

備註

WSAQUERYSET2結構會當做 Windows Vista 和更新版本上可用的命名空間服務提供者第 2 版 (NSPv2) 架構的一部分使用。

在 Windows Vista 和 Windows Server 2008 上， WSAQUERYSET2 結構只能用於NS_EMAIL命名空間提供者上的作業。

注意

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

規格需求

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

另請參閱

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSASetService