GetNameByTypeA, fonction (nspapi.h)

Article
02/29/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, les documents de référence sont les suivants.

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

Syntaxe

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  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 façon unique le nom du service réseau.

[in] dwNameLength

Pointeur vers une variable qui, lors de l’entrée, spécifie la taille, en octets, de la mémoire tampon pointée par lpServiceName. Lors de la 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 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]
Plateforme cible	Windows
En-tête	nspapi.h
Bibliothèque	Mswsock.lib
DLL	Mswsock.dll

Voir aussi

GetTypeByName

Winsock Functions

Référence Winsock

Partager via