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 lequel la valeur du type de service réseau est destinée. 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 au sein de cet ensemble. L’ensemble des 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	Couche NetBIOS sur TCP/IP. Tous les systèmes d’exploitation Windows enregistrent 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 à la classeur NetWare le cas échéant. NS_SAP est un espace de noms dynamique qui permet l’inscription de 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 des 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 à celui-ci.

dwValueType

Type : DWORD

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

Valeur	Signification
REG_BINARY	Données binaires dans tout formulaire.
REG_DWORD	Nombre 32 bits.
REG_MULTI_SZ	Tableau de chaînes terminées par deux caractères nuls.
REG_SZ	Chaîne se terminant par une valeur null.

dwValueSize

Type : DWORD

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

lpValueName

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui est le nom de la valeur. Ce nom est spécifique à un espace de noms.

Plusieurs chaînes de noms de valeur couramment utilisées sont associées à des constantes définies. Ces chaînes de noms sont 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 d’objet BLOB ServiceSpecificInfo d’une structure SERVICE_INFO . Bien que le membre ServiceSpecificInfo ne doit généralement pas contenir de pointeurs, une exception est faite dans le cas des structures SERVICE_TYPE_INFO_ABS et SERVICE_TYPE_VALUE_ABS .

Notes

L’en-tête nspapi.h définit SERVICE_TYPE_VALUE_ABS comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	nspapi.h

Voir aussi

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService