getservbyport-Funktion (winsock2.h)

Artikel
08/27/2023

Die getservbyport-Funktion ruft Dienstinformationen ab, die einem Port und protokoll entsprechen.

Syntax

servent *WSAAPI getservbyport(
  [in] int        port,
  [in] const char *proto
);

Parameter

[in] port

Port für einen Dienst in Netzwerkbytereihenfolge.

[in] proto

Optionaler Zeiger auf einen Protokollnamen. Wenn dies NULL ist, gibt getservbyport den ersten Diensteintrag zurück, für den der Port mit dem s_port der Servent-Struktur übereinstimmt. Andernfalls stimmt getservbyport sowohl mit den Port- als auch mit den Protoparametern überein .

Rückgabewert

Wenn kein Fehler auftritt, gibt getservbyport 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.
WSAEFAULT	Der proto-Parameter ist kein gültiger Teil des Benutzeradressraums.
WSAEINTR	Ein blockierender Windows Socket 1.1-Aufruf wurde über WSACancelBlockingCall abgebrochen.

Hinweise

Die getservbyport-Funktion gibt wie in der getservbyname-Funktion einen Zeiger auf eine Servent-Struktur zurück.

Die Servent-Struktur wird von Windows Sockets zugeordnet. 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 unter Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen


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	winsock2.h (Winsock2.h einschließen)
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll

Weitere Informationen

WSAAsyncGetServByPort

Winsock-Funktionen

Winsock-Referenz

getservbyname

Share via