SERVICE_INFOA structure (nspapi.h)

Article
03/04/2024

La structure SERVICE_INFO contient des informations sur un service réseau ou un type de service réseau.

Syntaxe

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Membres

lpServiceType

Type : LPGUID

Pointeur vers un GUID qui est le type du service réseau.

lpServiceName

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui est le nom du service réseau.

Si vous appelez la fonction SetService avec le paramètre dwNameSpace défini sur NS_DEFAULT, le nom du service réseau doit être un nom commun. Un nom commun est ce que le service réseau est communément appelé. Un exemple de nom commun pour un service réseau est « Mon SQL Server ».

Si vous appelez la fonction SetService avec le paramètre dwNameSpace défini sur un nom de service spécifique, le nom du service réseau peut être un nom commun ou un nom unique. Un nom unique distingue le service à un emplacement unique avec un service d’annuaire. Un exemple de nom unique pour un service réseau est « MS\SYS\NT\DEV\My SQL Server ».

lpComment

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui est un commentaire ou une description pour le service réseau. Par exemple, « Utilisé pour les mises à niveau de développement ».

lpLocale

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui contient des informations de paramètres régionaux.

dwDisplayHint

Type : DWORD

Conseil sur la façon d’afficher le service réseau dans une interface utilisateur de navigation réseau. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
RESOURCEDISPLAYTYPE_DOMAIN	Afficher le service réseau en tant que domaine.
RESOURCEDISPLAYTYPE_FILE	Afficher le service réseau sous la forme d’un fichier.
RESOURCEDISPLAYTYPE_GENERIC	La méthode utilisée pour afficher l’objet n’a pas d’importance.
RESOURCEDISPLAYTYPE_GROUP	Afficher le service réseau sous forme de groupe.
RESOURCEDISPLAYTYPE_SERVER	Afficher le service réseau en tant que serveur.
RESOURCEDISPLAYTYPE_SHARE	Afficher le service réseau sous la forme d’un sharepoint.
RESOURCEDISPLAYTYPE_TREE	Afficher le service réseau sous forme d’arborescence.

dwVersion

Type : DWORD

Version du service réseau. Le mot haut de cette valeur spécifie un numéro de version principale. Le mot faible de cette valeur spécifie un numéro de version secondaire.

dwTime

Type : DWORD

Réservé pour un usage futur. Doit être zéro.

lpMachineName

Type : LPTSTR

Pointeur vers une chaîne terminée par NULL qui est le nom de l’ordinateur sur lequel le service réseau s’exécute.

lpServiceAddress

Type : LPSERVICE_ADDRESSES

Pointeur vers une structure SERVICE_ADDRESSES qui contient un tableau de structures SERVICE_ADDRESS . Chaque structure SERVICE_ADDRESS contient des informations sur une adresse de service réseau.

Un service réseau peut appeler la fonction getsockname pour déterminer l’adresse locale du système.

ServiceSpecificInfo

Type : BLOB

Structure BLOB qui spécifie des informations définies par le service.

Note En général, les données pointées par le membre pBlobData de la structure BLOB ne doivent pas contenir de pointeurs. Cela est dû au fait que seul le service réseau connaît le format des données ; la copie des données sans ces connaissances entraînerait l’invalidation du pointeur. Si les données pointées par pBlobData contiennent des éléments de taille variable, les décalages de pBlobData peuvent être utilisés pour indiquer l’emplacement de ces éléments. Il existe une exception à cette règle générale : quand pBlobData pointe vers une structure SERVICE_TYPE_INFO_ABS . Cela est possible, car la structure SERVICE_TYPE_INFO_ABS et toutes les structures SERVICE_TYPE_VALUE_ABS qu’elle contient sont prédéfinies et, par conséquent, leurs formats sont connus du système d’exploitation.

Remarques

Notes

L’en-tête nspapi.h définit SERVICE_INFO 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. La combinaison 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