getservbyport-Funktion (winsock.h)
Die getservbyport-Funktion ruft Dienstinformationen ab, die einem Port und Protokoll entsprechen.
Syntax
servent * 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 Serventstruktur übereinstimmt. Andernfalls entspricht getservbyport sowohl dem Port als auch den Protoparametern .
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 |
|---|---|
| Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen. | |
| Beim Netzwerksubsystem ist ein Fehler aufgetreten. | |
| Autorisierender Antwortdienst nicht gefunden. | |
| Ein nicht autoritarativer Dienst nicht gefunden oder ein Serverfehler. | |
| Nicht behebbare Fehler, auf die Dienstdatenbank kann nicht zugegriffen werden. | |
| Gültiger Name, kein Datensatz des angeforderten Typs. | |
| Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion. | |
| Der proto-Parameter ist kein gültiger Teil des Benutzeradressraums. | |
| 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 Serventstruktur 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 nur eine Kopie dieser Struktur pro Thread zugewiesen, 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 auf Windows Phone 8 und höher 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 (einschließlich Winsock2.h) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |