GetNameByTypeA-Funktion (nspapi.h)

Die GetNameByType-Funktion ruft den Namen eines Netzwerkdiensts für den angegebenen Diensttyp ab.

Hinweis Die GetNameByType-Funktion ist eine Microsoft-spezifische Erweiterung der Windows Sockets 1.1-Spezifikation. Diese Funktion ist veraltet. Zur Vereinfachung von Windows Sockets 1.1-Entwicklern lautet das Referenzmaterial wie folgt.

 

Hinweis Die unter Protokollunabhängige Namensauflösung beschriebenen Funktionen bieten entsprechende Funktionen in Windows Sockets 2.

 

Syntax

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Parameter

[in] lpServiceType

Ein Zeiger auf einen global eindeutigen Bezeichner (Globally Unique Identifier, GUID), der den Typ des Netzwerkdiensts angibt. Die Svcguid.h-Headerdatei enthält Definitionen mehrerer GUID-Diensttypen und Makros für die Arbeit mit ihnen.

Die Headerdatei Svcguid.h wird nicht automatisch von der Winsock2.h-Headerdatei eingeschlossen.

[out] lpServiceName

Ein Zeiger auf einen Puffer zum Empfangen einer Zeichenfolge mit Nullende, die den Namen des Netzwerkdiensts eindeutig darstellt.

[in] dwNameLength

Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers in Bytes angibt, auf den lpServiceName verweist. Bei der Ausgabe enthält die Variable die tatsächliche Größe der Dienstnamenzeichenfolge in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert nicht SOCKET_ERROR (–1).

Wenn die Funktion fehlschlägt, ist der Rückgabewert SOCKET_ERROR (–1). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der nspapi.h-Header definiert GetNameByType als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	nspapi.h
Bibliothek	Mswsock.lib
DLL	Mswsock.dll

Weitere Informationen

GetTypeByName

Winsock-Funktionen

Winsock-Referenz