WSAQUERYSET (Windows Sockets) (Windows CE 5.0)
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