Compartilhar via


WSAQUERYSET (Windows Sockets)

Windows Mobile SupportedWindows Embedded CE Supported

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)