Freigeben über


getprotobyname-Funktion (winsock.h)

Die getprotobyname-Funktion ruft die Protokollinformationen ab, die einem Protokollnamen entsprechen.

Syntax

protoent * getprotobyname(
  [in] const char *name
);

Parameter

[in] name

Zeiger auf einen Protokollnamen mit NULL-Beendigung.

Rückgabewert

Wenn kein Fehler auftritt, gibt getprotobyname einen Zeiger auf den Protoens 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
Autorisierendes Antwortprotokoll nicht gefunden.
WSATRY_AGAIN
Ein nicht authentifiziertes Protokoll wurde nicht gefunden, oder ein Serverfehler.
WSANO_RECOVERY
Nicht behebbare Fehler: Auf die Protokolldatenbank 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 Name-Parameter ist kein gültiger Teil des Benutzeradressraums.
WSAEINTR
Ein blockierender Windows Socket 1.1-Aufruf wurde über WSACancelBlockingCall abgebrochen.

Hinweise

Die getprotobyname-Funktion gibt einen Zeiger auf die Protoens-Struktur zurück, die den Namen und die Protokollnummer enthält, die dem im name-Parameter angegebenen Protokoll entsprechen. Alle Zeichenfolgen sind NULL-endend. Die protoente Struktur wird von der Windows Sockets-Bibliothek zugeordnet. Eine Anwendung darf niemals versuchen, diese Struktur zu ändern oder ihre Komponenten frei zu geben. Darüber hinaus wird wie hostent nur eine Kopie dieser Struktur pro Thread zugeordnet, 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 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

WSAAsyncGetProtoByName

Winsock-Funktionen

Winsock-Referenz

getprotobynumber