GetNameByTypeW, fonction (nspapi.h)

Article
03/04/2024

La fonction GetNameByType récupère le nom d’un service réseau pour le type de service spécifié.

Note La fonction GetNameByType est une extension propre à Microsoft à la spécification Windows Sockets 1.1. Cette fonction est obsolète. Pour la commodité des développeurs Windows Sockets 1.1, le matériel de référence est le suivant.

Note Les fonctions détaillées dans Résolution de noms indépendants du protocole fournissent des fonctionnalités équivalentes dans les sockets Windows 2.

Syntaxe

INT GetNameByTypeW(
  [in]  LPGUID lpServiceType,
  [out] LPWSTR lpServiceName,
  [in]  DWORD  dwNameLength
);

Paramètres

[in] lpServiceType

Pointeur vers un identificateur global unique (GUID) qui spécifie le type du service réseau. Le fichier d’en-tête Svcguid.h inclut des définitions de plusieurs types de services GUID et des macros pour les utiliser.

Le fichier d’en-tête Svcguid.h n’est pas automatiquement inclus par le fichier d’en-tête Winsock2.h .

[out] lpServiceName

Pointeur vers une mémoire tampon pour recevoir une chaîne sans fin qui représente de manière unique le nom du service réseau.

[in] dwNameLength

Pointeur vers une variable qui, en entrée, spécifie la taille, en octets, de la mémoire tampon pointée par lpServiceName. En sortie, la variable contient la taille réelle de la chaîne de nom de service, en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour n’est pas SOCKET_ERROR (–1).

Si la fonction échoue, la valeur de retour est SOCKET_ERROR (–1). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête nspapi.h définit GetNameByType 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]
Plateforme cible	Windows
En-tête	nspapi.h
Bibliothèque	Mswsock.lib
DLL	Mswsock.dll

Voir aussi

GetTypeByName

Fonctions Winsock

Informations de référence sur Winsock

Partager via