Estructura WSAQUERYSETA (winsock2.h)

La estructura WSAQUERYSET de proporciona información relevante sobre un servicio determinado, incluido el identificador de clase de servicio, el nombre del servicio, el identificador de espacio de nombres y la información de protocolo aplicables, así como un conjunto de direcciones de transporte en las que escucha el servicio.

Sintaxis

typedef struct _WSAQuerySetA {
  DWORD         dwSize;
  LPSTR         lpszServiceInstanceName;
  LPGUID        lpServiceClassId;
  LPWSAVERSION  lpVersion;
  LPSTR         lpszComment;
  DWORD         dwNameSpace;
  LPGUID        lpNSProviderId;
  LPSTR         lpszContext;
  DWORD         dwNumberOfProtocols;
  LPAFPROTOCOLS lpafpProtocols;
  LPSTR         lpszQueryString;
  DWORD         dwNumberOfCsAddrs;
  LPCSADDR_INFO lpcsaBuffer;
  DWORD         dwOutputFlags;
  LPBLOB        lpBlob;
} WSAQUERYSETA, *PWSAQUERYSETA, *LPWSAQUERYSETA;

Miembros

dwSize

Tipo: DWORD de

Tamaño, en bytes, de la estructura de WSAQUERYSET. Este miembro se usa como mecanismo de control de versiones, ya que el tamaño del WSAQUERYSET estructura ha cambiado en versiones posteriores de Windows.

lpszServiceInstanceName

Tipo: LPTSTR de

Puntero a una cadena opcional terminada en NULL que contiene el nombre del servicio. La semántica para usar caracteres comodín dentro de la cadena no se define, pero puede ser compatible con determinados proveedores de espacios de nombres.

lpServiceClassId

Tipo: LPGUID

GUID correspondiente a la clase de servicio. Este miembro debe establecerse.

lpVersion

Tipo: LPWSAVERSION

Puntero a un número de versión deseado opcional del proveedor de espacios de nombres. Este miembro proporciona semántica de comparación de versiones (es decir, la versión solicitada debe coincidir exactamente o la versión no debe ser menor que el valor proporcionado).

lpszComment

Tipo: LPTSTR de

Este miembro se omite para las consultas.

dwNameSpace

Tipo: DWORD de

Identificador de espacio de nombres que determina qué proveedores de espacios de nombres se consultan. Pasar un identificador de espacio de nombres específico solo dará lugar a proveedores de espacios de nombres que admitan el espacio de nombres especificado que se está consultando. Al especificar NS_ALL se consultarán todos los proveedores de espacios de nombres instalados y activos.

Las opciones del miembro dwNameSpace de se muestran en el archivo de inclusión de Winsock2.h. Se incluyen varios proveedores de espacios de nombres nuevos con Windows Vista y versiones posteriores. Se pueden instalar otros proveedores de espacios de nombres, por lo que los siguientes valores posibles son solo los disponibles con frecuencia. Muchos otros valores son posibles.

lpNSProviderId

Tipo: LPGUID

Puntero a un GUID opcional de un proveedor de espacio de nombres específico para consultar en caso de que varios proveedores de espacios de nombres se registren en un único espacio de nombres, como NS_DNS. Si se pasa el GUID de un proveedor de espacio de nombres específico, solo se consultará el proveedor de espacio de nombres especificado. Se puede llamar a WSAEnumNameSpaceProviders y funciones WSAEnumNameSpaceProvidersEx para recuperar el GUID de un proveedor de espacios de nombres.

lpszContext

Tipo: LPTSTR de

Puntero a un punto de partida opcional de la consulta en un espacio de nombres jerárquico.

dwNumberOfProtocols

Tipo: DWORD de

Tamaño, en bytes, de la matriz de restricciones de protocolo. Este miembro puede ser cero.

lpafpProtocols

Tipo: LPAFPROTOCOLS

Puntero a una matriz opcional de estructuras de AFPROTOCOLS. Solo se devolverán los servicios que usan estos protocolos.

lpszQueryString

Tipo: LPTSTR de

Puntero a una cadena de consulta terminada en NULL opcional. Algunos espacios de nombres, como Whois++, admiten consultas enriquecidas de tipo SQL contenidas en una cadena de texto simple. Este parámetro se usa para especificar esa cadena.

dwNumberOfCsAddrs

Tipo: DWORD de

Este miembro se omite para las consultas.

lpcsaBuffer

Tipo: LPCSADDR_INFO

Este miembro se omite para las consultas.

dwOutputFlags

Tipo: DWORD de

Este miembro se omite para las consultas.

lpBlob

Tipo: LPBLOB de

Puntero opcional a los datos que se usan para consultar o establecer información de espacio de nombres específica del proveedor. El formato de esta información es específico del proveedor de espacios de nombres.

Observaciones

La estructura WSAQUERYSET se usa como parte de la arquitectura original del proveedor de espacios de nombres versión 1 disponible en Windows 95 y versiones posteriores. Hay disponible una versión 2 más reciente de la arquitectura del espacio de nombres en Windows Vista y versiones posteriores.

En la mayoría de los casos, las aplicaciones interesadas en solo un protocolo de transporte determinado deben restringir su consulta por familia de direcciones y protocolo en lugar de por espacio de nombres. Esto permitiría que una aplicación que necesite localizar un servicio TCP/IP, por ejemplo, tenga su consulta procesada por todos los espacios de nombres disponibles, como el archivo de hosts locales, DNS y NIS.

Requisitos

Consulte también

Bluetooth y WSAQUERYSET para la consulta de dispositivos

Bluetooth y WSAQUERYSET for Service Inquiry

Bluetooth y WSAQUERYSET para Set Service

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSALookupServiceBegin

WSALookupServiceNext

WSAQUERYSET2

WSASetService de