structure SERVICE_INFOA (nspapi.h)

Article
11/20/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 NULL-terminated 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 « My 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 NULL-terminated string 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 NULL-terminated qui contient des informations de paramètres régionaux.

dwDisplayHint

Type : DWORD

Indication de l’affichage du 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	Affichez le service réseau en tant que domaine.
RESOURCEDISPLAYTYPE_FILE	Affichez le service réseau en tant que fichier.
RESOURCEDISPLAYTYPE_GENERIC	La méthode utilisée pour afficher l’objet n’a pas d’importance.
RESOURCEDISPLAYTYPE_GROUP	Affichez le service réseau en tant que groupe.
RESOURCEDISPLAYTYPE_SERVER	Affichez le service réseau en tant que serveur.
RESOURCEDISPLAYTYPE_SHARE	Affichez le service réseau en tant que sharepoint.
RESOURCEDISPLAYTYPE_TREE	Affichez le service réseau en tant qu’arborescence.

dwVersion

Type : DWORD

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

dwTime

Type : DWORD

Réservé pour une utilisation ultérieure. Doit être égal à zéro.

lpMachineName

Type : LPTSTR

Pointeur vers une chaîne NULL-terminated, qui est le nom de l’ordinateur sur lequel le service réseau est en cours d’exécution.

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 les informations définies par le service.

Remarque En général, les données pointées par le blob structure pBlobData membre 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 une 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 : lorsque 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 leurs formats sont donc connus du système d’exploitation.

Remarques

Note

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