getservbyname-Funktion (winsock.h)

  • Artikel

Die getservbyname-Funktion ruft Dienstinformationen ab, die einem Dienstnamen und Protokoll entsprechen.

Syntax

servent * getservbyname(
  [in] const char *name,
  [in] const char *proto
);

Parameter

[in] name

Ein Zeiger auf einen Dienstnamen mit NULL-Beendigung.

[in] proto

Ein Zeiger auf einen Protokollnamen mit NULL-Beendigung. Wenn dieser Zeiger NULL ist, gibt die getservbyname-Funktion den ersten Diensteintrag zurück, bei dem name mit dem s_name Member der Serventstruktur oder dem s_aliases Member der Serventstruktur übereinstimmt. Andernfalls entspricht getservbyname sowohl dem Namen als auch dem Proto.

Rückgabewert

Wenn kein Fehler auftritt, gibt getservbyname einen Zeiger auf die Servent-Struktur zurück. Andernfalls wird ein NULL-Zeiger zurückgegeben, und eine bestimmte Fehlernummer kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode Bedeutung
WSANOTINITIALISIERT
 Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN
 Fehler beim Netzwerksubsystem.
WSAHOST_NOT_FOUND
 Autorisierender Antwortdienst nicht gefunden.
WSATRY_AGAIN
 Ein nicht authentifiziererischer Dienst wurde nicht gefunden, oder ein Serverfehler.
WSANO_RECOVERY
 Nicht behebbare Fehler: Auf die Dienstdatenbank kann nicht zugegriffen werden.
WSANO_DATA
 Gültiger Name, kein Datensatz des angeforderten Typs.
WSAEINPROGRESS
 Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet noch eine Rückruffunktion.
WSAEINTR
 Ein blockierender Windows Socket 1.1-Aufruf wurde über WSACancelBlockingCall abgebrochen.

Hinweise

Die getservbyname-Funktion gibt einen Zeiger auf die Serventstruktur zurück, die die Namen und die Dienstnummer enthält, die mit der Zeichenfolge im name-Parameter übereinstimmen. Alle Zeichenfolgen sind NULL-endend.

Der zurückgegebene Zeiger verweist auf die Von der Windows Sockets-Bibliothek zugeordnete Serventstruktur . Die Anwendung darf niemals versuchen, diese Struktur zu ändern oder ihre Komponenten frei zu geben. Darüber hinaus wird pro Thread nur eine Kopie dieser Struktur zugeordnet, sodass die Anwendung alle benötigten Informationen kopieren sollte, bevor sie andere Windows Sockets-Funktionsaufrufe ausgibt.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winsock.h (Winsock2.h einschließen)
Bibliothek Ws2_32.lib
DLL Ws2_32.dll

Weitere Informationen

WSAAsyncGetServByName

Winsock-Funktionen

Winsock-Referenz

getservbyport