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