estructura WSANAMESPACE_INFOEXA (winsock2.h)

  • Artículo

La estructura WSANAMESPACE_INFOEX contiene toda la información de registro de un proveedor de espacio de nombres.

Sintaxis

typedef struct _WSANAMESPACE_INFOEXA {
  GUID  NSProviderId;
  DWORD dwNameSpace;
  BOOL  fActive;
  DWORD dwVersion;
  LPSTR lpszIdentifier;
  BLOB  ProviderSpecific;
} WSANAMESPACE_INFOEXA, *PWSANAMESPACE_INFOEXA, *LPWSANAMESPACE_INFOEXA;

Miembros

NSProviderId

Tipo: GUID

Un GUID único para este proveedor de espacios de nombres.

dwNameSpace

Tipo: DWORD

Espacio de nombres admitido por este proveedor.

Los valores posibles para el miembro dwNameSpace se enumeran en el archivo de inclusión Winsock2.h . Varios proveedores de espacios de nombres se incluyen 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.

Valor Significado
NS_BTH
 Espacio de nombres Bluetooth.

Este identificador de espacio de nombres se admite en Windows Vista y versiones posteriores.
NS_DNS
 Espacio de nombres del sistema de nombres de dominio (DNS).
NS_EMAIL
 Espacio de nombres de correo electrónico.

Este identificador de espacio de nombres se admite en Windows Vista y versiones posteriores.
NS_NLA
 Espacio de nombres de reconocimiento de ubicación de red (NLA).

Este identificador de espacio de nombres es compatible con Windows XP y versiones posteriores.
NS_NTDS
 Espacio de nombres del servicio de directorio NT (NTDS) de Windows.
NS_PNRPNAME
 Espacio de nombres punto a punto para un nombre del mismo nivel específico.

Este identificador de espacio de nombres se admite en Windows Vista y versiones posteriores.
NS_PNRPCLOUD
 Espacio de nombres punto a punto para una colección de nombres del mismo nivel.

Este identificador de espacio de nombres se admite en Windows Vista y versiones posteriores.

fActive

Tipo: BOOL

Si es TRUE, indica que este proveedor de espacios de nombres está activo. Si es FALSE, el proveedor de espacios de nombres está inactivo y no es accesible para las consultas, incluso si la consulta hace referencia específicamente a este proveedor de espacios de nombres.

dwVersion

Tipo: DWORD

Número de versión del proveedor de espacio de nombres.

lpszIdentifier

Tipo: LPTSTR

Cadena para mostrar que identifica el proveedor de espacios de nombres.

ProviderSpecific

Tipo: BLOB

Un blob de datos específico del proveedor asociado a la entrada del espacio de nombres.

Comentarios

La estructura WSANAMESPACE_INFOEX es una versión mejorada de la estructura de WSANAMESPACE_INFO que usa WSAEnumNameSpaceProvidersEx y las funciones WSCEnumNameSpaceProvidersEx32 para devolver información sobre los proveedores de espacios de nombres disponibles. La estructura de WSANAMESPACE_INFOEX contiene el blob de datos específico del proveedor asociado a la entrada de espacio de nombres pasada en el parámetro lpProviderInfo a las funciones WSCInstallNameSpaceEx y WSCInstallNameSpaceEx32 .

Actualmente, el único espacio de nombres incluido con Windows que usa información en el miembro ProviderSpecific de la estructura WSANAMESPACE_INFOEX son proveedores de espacios de nombres para el espacio de nombres NS_EMAIL. El formato del miembro ProviderSpecific para un proveedor de espacio de nombres NS_EMAIL es una estructura NAPI_PROVIDER_INSTALLATION_BLOB .

Cuando se define UNICODE o _UNICODE, WSANAMESPACE_INFOEX se define en WSANAMESPACE_INFOEXW, la versión Unicode de esta estructura y el miembro de cadena lpszIdentifier se define en el tipo de datos LPWSTR .

Cuando no se define UNICODE o _UNICODE, WSANAMESPACE_INFOEX se define en WSANAMESPACE_INFOEXA, la versión ANSI de esta estructura y el miembro de cadena lpszIdentifier se define en el tipo de datos LPSTR .

La función WSCEnumNameSpaceProvidersEx32 es solo una función Unicode y devuelve WSANAMESPACE_INFOEXW estructuras.

Nota

El encabezado winsock2.h define WSANAMESPACE_INFOEX 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado winsock2.h

Consulte también

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32