WSAQUERYSET (Windows Sockets)

9/8/2008

Essa estrutura oferece informações relevantes sobre um determinado serviço, incluindo classe serviço identificação, Nome serviço, aplicável Nome-espaço identificador e protocolo informações, bem como um conjunto de endereços transporte no qual o serviço escuta.

Syntax

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;

Os membros

• dwSize
  Deve ser definido como sizeof (WSAQUERYSET). Este é um mecanismo versionamento.

• dwOutputFlags
  Ignorado para consultas.

• lpszServiceInstanceName
  (Opcional) Seqüência de caracteres de referência contém nome serviço. A semântica de uso de curingas dentro de seqüência de caracteres não estiverem definida, mas pode ser com suporte por determinados Provedores espaço Nome.

• lpServiceClassId
  (Obrigatório) O GUID correspondente para a classe serviço.

• lpVersion
  (Opcional) Referências número versão desejada e fornece a semântica de comparação versão (ou seja, versão deve coincidir exatamente, ou versão deve não ser menor do que o valor fornecido).

• lpszComment
  Ignorado para consultas.

• dwNameSpace
  Identificador de um espaço único nome de restringir a pesquisa, ou NS_ALL para incluir todos os espaços Nome.

• lpNSProviderId
  (Opcional) Faz referência a GUID de um nome específico-provedor espaço e limita a consulta para esse provedor só.

• lpszContext
  (Opcional) Especifica a raiz da consulta em um hierárquico Nome espaço.

• dwNumberOfProtocols
  Tamanho do protocolo matriz restrição, pode ser zero.

• lpafpProtocols
  (Opcional) Uma matriz de referências AFPROTOCOLS estrutura. Somente os serviços que utilizam esses protocolos serão retornados.

• lpszQueryString
  (Opcional)Alguns nomes consultas SQL-como suporte enriched espaços (como whois ++) contidas em um seqüência de caracteres de texto simples. Este parâmetro é usado para especificar que seqüência de caracteres.

• dwNumberOfCsAddrs
  Ignorado para consultas.

• lpcsaBuffer
  Ignorado para consultas.

• lpBlob
  (Opcional) Este é um ponteiro para uma entidade Provider-specific.

Remarks

Na maioria dos casos, os aplicativos interessados em apenas um protocolo específico transporte devem restringir seu consulta por família de endereços e protocolo rather than pelo nome espaço. Isso permitiria que um aplicativo que precisa localizar um TCP/IP serviço, de exemplo, para ter sua consulta processada por todos os disponível nome espaços such as o local arquivo hosts, sistema de nome de domínio (DNS) e o NIS.

Requirements

Header	winsock2.h
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

WSASetService (Windows Sockets)
WSALookupServiceBegin (Windows Sockets)
WSALookupServiceNext (Windows Sockets)