GetNameByTypeA, fonction (nspapi.h)

Article
11/20/2024

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

Remarque La fonction GetNameByType est une extension spécifique à 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.

Remarque Les fonctions détaillées dans Protocol-Independent résolution de noms 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 service 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, 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 de retour

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’erreur étendues, appelez GetLastError.

Remarques

Note

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. 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]
plateforme cible	Windows
d’en-tête	nspapi.h
bibliothèque	Mswsock.lib
DLL	Mswsock.dll

Voir aussi

GetTypeByName

fonctions Winsock

de référence Winsock

Partager via