estructura WSAQUERYSET2W (winsock2.h)
La estructura de WSAQUERYSET2 proporciona información relevante sobre un servicio determinado, incluido el identificador de clase de servicio, el nombre del servicio, el identificador del 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 _WSAQuerySet2W {
DWORD dwSize;
LPWSTR lpszServiceInstanceName;
LPWSAVERSION lpVersion;
LPWSTR lpszComment;
DWORD dwNameSpace;
LPGUID lpNSProviderId;
LPWSTR lpszContext;
DWORD dwNumberOfProtocols;
LPAFPROTOCOLS lpafpProtocols;
LPWSTR lpszQueryString;
DWORD dwNumberOfCsAddrs;
LPCSADDR_INFO lpcsaBuffer;
DWORD dwOutputFlags;
LPBLOB lpBlob;
} WSAQUERYSET2W, *PWSAQUERYSET2W, *LPWSAQUERYSET2W;
Miembros
dwSize
Tipo: DWORD de
Tamaño, en bytes, de la estructura WSAQUERYSET2. Este miembro se usa como mecanismo de control de versiones, ya que el tamaño de la estructura de WSAQUERYSET2 puede cambiar en versiones posteriores de Windows.
lpszServiceInstanceName
Tipo: LPTSTR de
Puntero a un null opcionalcadena terminada 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.
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
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 un null opcionalcadena de consulta terminada. 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 WSAQUERYSET2 se usa como parte de la arquitectura del proveedor de servicios de espacio de nombres versión 2 (NSPv2) disponible en Windows Vista y versiones posteriores.
En Windows Vista y Windows Server 2008, la estructura de WSAQUERYSET2 solo se puede usar para las operaciones en proveedores de espacios de nombres NS_EMAIL.
Nota
El encabezado winsock2.h define WSAQUERYSET2 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| encabezado de |
winsock2.h |
Consulte también
WSASetService de