Compartir a través de


estructura WSANAMESPACE_INFOEXW (winsock2.h)

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

Sintaxis

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

Miembros

NSProviderId

Tipo: GUID de

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

dwNameSpace

Tipo: DWORD de

Espacio de nombres admitido por este proveedor.

Los valores posibles para el miembro dwNameSpace de se muestran en el archivo de inclusión de 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 se admite en Windows XP y versiones posteriores.

NS_NTDS
Espacio de nombres del servicio de directorios de Windows NT (NTDS).
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 de

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

dwVersion

Tipo: DWORD de

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

lpszIdentifier

Tipo: LPTSTR de

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

ProviderSpecific

Tipo: blob de

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

Observaciones

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

Actualmente, el único espacio de nombres incluido con Windows que usa información en el ProviderSpecific miembro de la estructura de WSANAMESPACE_INFOEX son proveedores de espacios de nombres para el espacio de nombres NS_EMAIL. El formato del miembro ProviderSpecific de 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 de lpszIdentifier se define en el tipo de datos LPWSTR.

Cuando no se define UNICODE o _UNICODE, WSANAMESPACE_INFOEX se define para 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 una función solo Unicode y devuelve estructuras WSANAMESPACE_INFOEXW.

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 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

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32