GetTypeByNameA-Funktion (nspapi.h)

Artikel
03/04/2024

Die GetTypeByName-Funktion ruft eine Diensttyp-GUID für einen durch den Namen angegebenen Netzwerkdienst ab.

Hinweis Die GetTypeByName-Funktion ist eine Microsoft-spezifische Erweiterung der Windows Sockets 1.1-Spezifikation. Diese Funktion ist veraltet. Zur Vereinfachung von Windows Sockets 1.1-Entwicklern ist dieses Referenzmaterial enthalten. Die unter Protokollunabhängige Namensauflösung beschriebenen Funktionen bieten entsprechende Funktionen in Windows Sockets 2.

Syntax

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

Parameter

[in] lpServiceName

Ein Zeiger auf eine Zeichenfolge mit Nullen, die den Namen des Diensts eindeutig darstellt. Beispiel: "MY SNA SERVER".

[in, out] lpServiceType

Ein Zeiger auf eine Variable zum Empfangen eines global eindeutigen Bezeichners (Globally Unique Identifier, GUID), der den Typ des Netzwerkdiensts angibt. Die Headerdatei Svcguid.h 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.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“.

Wenn die Funktion fehlschlägt, lautet der Rückgabewert SOCKET_ERROR( – 1). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf, wodurch der folgende erweiterte Fehlerwert zurückgegeben wird.

Wert	Bedeutung
ERROR_SERVICE_DOES_NOT_EXIST	Der angegebene Diensttyp ist unbekannt.

Hinweise

Hinweis

Der nspapi.h-Header definiert GetTypeByName 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

GetNameByType

Winsock-Funktionen

Winsock-Referenz

Freigeben über