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

See Also

Reference

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