Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This structure provides relevant information about a given service, including service class ID, service name, applicable name-space identifier and protocol information, as well as a set of transport addresses at which the service listens.
typedef struct _WSAQuerySet {DWORD dwSize;LPTSTR lpszServiceInstanceName;LPGUID lpServiceClassId;LPWSAVERSION lpVersion;LPTSTR lpszComment;DWORD dwNameSpace;LPGUID lpNSProviderId;LPTSTR lpszContext;DWORD dwNumberOfProtocols;LPAFPROTOCOLS lpafpProtocols;LPTSTR lpszQueryString;DWORD dwNumberOfCsAddrs;LPCSADDR_INFO lpcsaBuffer;DWORD dwOutputFlags;LPBLOB lpBlob;} WSAQUERYSET, *PWSAQUERYSETW;
Members
- dwSize
Must be set to sizeof(WSAQUERYSET). This is a versioning mechanism. - dwOutputFlags
Ignored for queries. - lpszServiceInstanceName
(Optional) Referenced string contains service name. The semantics for using wildcards within the string are not defined, but can be supported by certain name space providers. - lpServiceClassId
(Required) The GUID corresponding to the service class. - lpVersion
(Optional) References desired version number and provides version comparison semantics (that is, version must match exactly, or version must be not less than the value supplied). - lpszComment
Ignored for queries. - dwNameSpace
Identifier of a single name space in which to constrain the search, or NS_ALL to include all name spaces. - lpNSProviderId
(Optional) References the GUID of a specific name-space provider, and limits the query to this provider only. - lpszContext
(Optional) Specifies the starting point of the query in a hierarchical name space. - dwNumberOfProtocols
Size of the protocol constraint array, can be zero. - lpafpProtocols
(Optional) References an array of AFPROTOCOLS structure. Only services that utilize these protocols will be returned. - lpszQueryString
(Optional)**Some name spaces (such as Whois++) support enriched SQL-like queries that are contained in a simple text string. This parameter is used to specify that string. - dwNumberOfCsAddrs
Ignored for queries. - lpcsaBuffer
Ignored for queries. - lpBlob
(Optional)**This is a pointer to a provider-specific entity.
Remarks
In most instances, applications interested in only a particular transport protocol should constrain their query by address family and protocol rather than by name space. This would allow an application that needs to locate a TCP/IP service, for example, to have its query processed by all available name spaces such as the local hosts file, DNS, and NIS.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.
See Also
WSASetService (Windows Sockets) | WSALookupServiceBegin (Windows Sockets) | WSALookupServiceNext (Windows Sockets)
Send Feedback on this topic to the authors