getprotobynumber-Funktion (winsock.h)
Die getprotobynumber-Funktion ruft Protokollinformationen ab, die einer Protokollnummer entsprechen.
Syntax
protoent * getprotobynumber(
int proto
);
Parameter
proto
TBD
Rückgabewert
Wenn kein Fehler auftritt, gibt getprotobynumber einen Zeiger auf die Protoensstruktur 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. | |
| Autorisierendes Antwortprotokoll wurde nicht gefunden. | |
| Ein nicht authentifiziertes Protokoll nicht gefunden oder ein Serverfehler. | |
| Nicht behebbare Fehler, auf die Protokolldatenbank 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. | |
| Ein blockierender Windows Socket 1.1-Aufruf wurde über WSACancelBlockingCall abgebrochen. |
Hinweise
Diese getprotobynumber-Funktion gibt einen Zeiger auf die Protoensstruktur zurück, wie zuvor in getprotobyname beschrieben. Der Inhalt der Struktur entspricht der angegebenen Protokollnummer.
Der Zeiger, der auf die von Windows Sockets zugewiesene Struktur zurückgegeben wird. 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 Informationen kopieren sollte, die sie benötigt, 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 |