structure SERVICE_INFOW (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_INFOW {
  LPGUID              lpServiceType;
  LPWSTR              lpServiceName;
  LPWSTR              lpComment;
  LPWSTR              lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPWSTR              lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOW, *PSERVICE_INFOW, *LPSERVICE_INFOW;

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

Une indication de 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	Affichez le service réseau en tant que domaine.
RESOURCEDISPLAYTYPE_FILE	Affichez le service réseau sous forme de 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 sous forme d’arborescence.

dwVersion

Type : DWORD

Version du service réseau. Le mot élevé de cette valeur spécifie un numéro de version principal. Le mot bas 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. En effet, seul le service réseau connaît le format des données ; la copie des données à l’insu de ce type 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 leurs formats sont donc connus du système d’exploitation.

Remarques

Notes

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