GetTypeByNameW-Funktion (nspapi.h)

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

Hinweis Die GetTypeByName-Funktion ist eine microsoftspezifische Erweiterung für die Windows Sockets 1.1-Spezifikation. Diese Funktion ist veraltet. Für die Benutzerfreundlichkeit von Windows Sockets 1.1-Entwicklern ist dieses Referenzmaterial enthalten. Die in Protocol-Independent Namensauflösung beschriebenen Funktionen entsprechende Funktionen in Windows Sockets 2 bereitstellen.

 

Syntax

INT GetTypeByNameW(
  [in]      LPWSTR lpServiceName,
  [in, out] LPGUID lpServiceType
);

Parameter

[in] lpServiceName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, 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 (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 Svcguid.h Headerdatei wird nicht automatisch von der Winsock2.h Headerdatei eingeschlossen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert SOCKET_ERROR( – 1). Rufen Sie zum Abrufen erweiterter Fehlerinformationen GetLastErrorauf, der den folgenden erweiterten Fehlerwert zurückgibt.

Wert	Bedeutung
ERROR_SERVICE_DOES_NOT_EXIST	Der angegebene Diensttyp ist unbekannt.

Bemerkungen

Anmerkung

Der nspapi.h-Header definiert GetTypeByName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	nspapi.h
Library	Mswsock.lib
DLL-	Mswsock.dll

Siehe auch

GetNameByType-

Winsock-Funktionen

Winsock Reference