estructura de WSANAMESPACE_INFOW (winsock2.h)

Artículo
08/27/2023

La estructura WSANAMESPACE_INFO contiene toda la información de registro de un proveedor de espacios de nombres.

Sintaxis

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

Miembros

NSProviderId

Tipo: GUID

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 aparecen 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 se admite en Windows XP y versiones posteriores.
NS_NTDS	Espacio de nombres del servicio de directorio 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

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.

Comentarios

Las funciones WSAEnumNameSpaceProviders y WSCEnumNameSpaceProviders usan la estructura de WSANAMESPACE_INFO para devolver información sobre los proveedores de espacios de nombres disponibles. La estructura de WSANAMESPACE_INFO contiene la información específica del proveedor en la entrada de espacio de nombres que se pasa a las funciones WSCInstallNameSpace y WSCInstallNameSpace32 cuando se instaló el proveedor de espacios de nombres.

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

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

En Windows Vista y versiones posteriores, WSANAMESPACE_INFOEX, una versión mejorada de la estructura de WSANAMESPACE_INFO , se devuelve mediante llamadas a las funciones WSAEnumNameSpaceProvidersEx y WSCEnumNameSpaceProvidersEx32 .

Nota

El encabezado winsock2.h define WSANAMESPACE_INFO 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winsock2.h