estructura SERVICE_TYPE_VALUE_ABSA (nspapi.h)

La estructura SERVICE_TYPE_VALUE_ABS contiene información sobre un valor de tipo de servicio de red. Esta información puede ser específica de un espacio de nombres.

Sintaxis

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

Miembros

dwNameSpace

Tipo: DWORD

Un espacio de nombres, o un conjunto de espacios de nombres predeterminados, para los que está previsto el valor del tipo de servicio de red. Los proveedores de espacios de nombres solo examinarán los valores destinados a su espacio de nombres.

Use una de las siguientes constantes para especificar un espacio de nombres:

Valor	Significado
NS_DEFAULT	Conjunto de espacios de nombres predeterminados. La función consulta cada espacio de nombres dentro de este conjunto. El conjunto de espacios de nombres predeterminados normalmente incluye todos los espacios de nombres instalados en el sistema. Sin embargo, los administradores del sistema pueden excluir espacios de nombres concretos del conjunto. NS_DEFAULT es el valor que la mayoría de las aplicaciones deben usar para dwNameSpace.
NS_DNS	Sistema de nombres de dominio usado en Internet para la resolución de nombres de host.
NS_NETBT	Nivel NetBIOS a través de TCP/IP. Todos los sistemas operativos Windows registran sus nombres de equipo con NetBIOS. Este espacio de nombres se usa para convertir un nombre de equipo en una dirección IP que usa este registro. Tenga en cuenta que NS_NETBT puede acceder a un servidor WINS para realizar la resolución.
NS_SAP	Protocolo de publicidad del servicio NetWare. Esto puede tener acceso a la enlazadora de NetWare si procede. NS_SAP es un espacio de nombres dinámico que permite el registro de servicios.
NS_TCPIP_HOSTS	Valor de búsqueda en el <archivo systemroot>\system32\drivers\etc\hosts.
NS_TCPIP_LOCAL	Mecanismos de resolución de nombres TCP/IP locales, incluidas las comparaciones con el nombre de host local y busca nombres de host y direcciones IP en la memoria caché del host en las asignaciones de direcciones IP.

dwValueType

Tipo: DWORD

Tipo de los datos de valor. Especifique uno de los siguientes tipos:

Valor	Significado
REG_BINARY	Datos binarios en cualquier formato.
REG_DWORD	Número de 32 bits.
REG_MULTI_SZ	Una matriz de cadenas terminadas en nulo, finalizada con dos caracteres null.
REG_SZ	Una cadena terminada en null.

dwValueSize

Tipo: DWORD

Tamaño, en bytes, del valor al que apunta el miembro lpValue . En el caso de REG_SZ y REG_MULTI_SZ datos de cadena, los caracteres de terminación se cuentan como parte del tamaño.

lpValueName

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que es el nombre del valor. Este nombre es específico de un espacio de nombres.

Varias cadenas de nombre de valor usadas habitualmente están asociadas a constantes definidas. Estas cadenas de nombre incluyen lo siguiente.

Constante	Significado
SERVICE_TYPE_VALUE_SAPID	"SapId"
SERVICE_TYPE_VALUE_CONN	"ConnectionOriented"
SERVICE_TYPE_VALUE_TCPPORT	"TcpPort"
SERVICE_TYPE_VALUE_UDPPORT	"UdpPort"

lpValue

Tipo: PVOID

Puntero a los datos de valor.

Comentarios

Cuando se usa la función SetService para agregar un tipo de servicio de red a un espacio de nombres, se pasa una estructura de SERVICE_TYPE_INFO_ABS como miembro BLOB ServiceSpecificInfo de una estructura de SERVICE_INFO . Aunque el miembro ServiceSpecificInfo generalmente no debe contener punteros, se realiza una excepción en el caso de las estructuras SERVICE_TYPE_INFO_ABS y SERVICE_TYPE_VALUE_ABS .

Nota

El encabezado nspapi.h define SERVICE_TYPE_VALUE_ABS 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	nspapi.h

Consulte también

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService