structure SERVICE_TYPE_VALUE_ABSA (nspapi.h)

La structure SERVICE_TYPE_VALUE_ABS contient des informations sur une valeur de type de service réseau. Ces informations peuvent être spécifiques à un espace de noms.

Syntaxe

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;

Membres

dwNameSpace

Type : DWORD

Un espace de noms ou un ensemble d’espaces de noms par défaut pour lesquels la valeur de type de service réseau est prévue. Les fournisseurs d’espaces de noms examinent uniquement les valeurs destinées à leur espace de noms.

Utilisez l’une des constantes suivantes pour spécifier un espace de noms :

Valeur	Signification
NS_DEFAULT	Ensemble d’espaces de noms par défaut. La fonction interroge chaque espace de noms dans cet ensemble. L’ensemble d’espaces de noms par défaut inclut généralement tous les espaces de noms installés sur le système. Toutefois, les administrateurs système peuvent exclure des espaces de noms particuliers de l’ensemble. NS_DEFAULT est la valeur que la plupart des applications doivent utiliser pour dwNameSpace.
NS_DNS	Système de noms de domaine utilisé dans Internet pour la résolution de noms d’hôte.
NS_NETBT	NetBIOS sur la couche TCP/IP. Tous les systèmes d’exploitation Windows inscrivent leurs noms d’ordinateurs auprès de NetBIOS. Cet espace de noms est utilisé pour convertir un nom d’ordinateur en adresse IP qui utilise cette inscription. Notez que NS_NETBT pouvez accéder à un serveur WINS pour effectuer la résolution.
NS_SAP	Protocole de publicité du service NetWare. Cela peut accéder au classeur NetWare le cas échéant. NS_SAP est un espace de noms dynamique qui autorise l’inscription des services.
NS_TCPIP_HOSTS	Valeur de recherche dans le fichier <systemroot>\system32\drivers\etc\hosts.
NS_TCPIP_LOCAL	Mécanismes de résolution de noms TCP/IP locaux, y compris les comparaisons par rapport au nom d’hôte local et recherche les noms d’hôte et les adresses IP dans le cache des mappages d’adresses IP de l’hôte.

dwValueType

Type : DWORD

Type des données de valeur. Spécifiez l’un des types suivants :

Valeur	Signification
REG_BINARY	Données binaires sous n’importe quel formulaire.
REG_DWORD	Nombre 32 bits.
REG_MULTI_SZ	Tableau de chaînes terminées par null, arrêtées par deux caractères Null.
REG_SZ	Chaîne terminée par null.

dwValueSize

Type : DWORD

Taille, en octets, de la valeur pointée par le membre lpValue. Dans le cas de REG_SZ et REG_MULTI_SZ données de chaîne, les caractères de fin sont comptabilisés dans le cadre de la taille.

lpValueName

Type : LPTSTR

Pointeur vers une chaîne NULL-terminated string qui est le nom de la valeur. Ce nom est spécifique à un espace de noms.

Plusieurs chaînes de nom de valeur couramment utilisées sont associées à des constantes définies. Ces chaînes de noms incluent les suivantes.

Constant	Signification
SERVICE_TYPE_VALUE_SAPID	« SapId »
SERVICE_TYPE_VALUE_CONN	« ConnectionOriented »
SERVICE_TYPE_VALUE_TCPPORT	« TcpPort »
SERVICE_TYPE_VALUE_UDPPORT	« UdpPort »

lpValue

Type : PVOID

Pointeur vers les données de valeur.

Remarques

Lorsque vous utilisez la fonction SetService pour ajouter un type de service réseau à un espace de noms, une structure SERVICE_TYPE_INFO_ABS est passée en tant que membre ServiceSpecificInfo BLOB d’une structure SERVICE_INFO. Bien que le membre ServiceSpecificInfo ne contienne généralement pas de pointeurs, une exception est faite dans le cas des structures SERVICE_TYPE_INFO_ABS et SERVICE_TYPE_VALUE_ABS.

Note

L’en-tête nspapi.h définit SERVICE_TYPE_VALUE_ABS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	nspapi.h

Voir aussi

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService