Funzione getprotobynumber (winsock2.h)

La funzione getprotobynumber recupera le informazioni sul protocollo corrispondenti a un numero di protocollo.

Sintassi

protoent *WSAAPI getprotobynumber(
  [in] int number
);

Parametri

[in] number

Numero di protocollo, nell'ordine dei byte host.

Valore restituito

Se non si verifica alcun errore, getprotobynumber restituisce un puntatore alla struttura protoent . In caso contrario, restituisce un puntatore Null e un numero di errore specifico può essere recuperato chiamando WSAGetLastError.

Codice di errore	Significato
WSANOTINITIALISED	Prima di usare questa funzione, è necessario che venga eseguita una chiamata WSAStartup riuscita.
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAHOST_NOT_FOUND	Protocollo di risposta autorevole non trovato.
WSATRY_AGAIN	Impossibile trovare un protocollo non autenticativo o un errore del server.
WSANO_RECOVERY	Errori irreversibili, il database dei protocolli non è accessibile.
WSANO_DATA	Nome valido, nessun record di dati di tipo richiesto.
WSAEINPROGRESS	È in corso una chiamata di Windows Sockets 1.1 bloccante oppure il provider di servizi sta ancora elaborando una funzione di callback.
WSAEINTR	Una chiamata di Windows Socket 1.1 bloccata è stata annullata tramite WSACancelBlockingCall.

Commenti

Questa funzione getprotobynumber restituisce un puntatore alla struttura protoent come descritto in precedenza in getprotobyname. Il contenuto della struttura corrisponde al numero di protocollo specificato.

Puntatore restituito punta alla struttura allocata da Windows Sockets. L'applicazione non deve mai tentare di modificare questa struttura o di liberare i relativi componenti. Inoltre, viene allocata una sola copia di questa struttura per ogni thread, quindi l'applicazione deve copiare tutte le informazioni necessarie prima di eseguire qualsiasi altra chiamata di funzione Di Windows Sockets.

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1, Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winsock2.h (include Winsock2.h)
Libreria	Ws2_32.lib
DLL	Ws2_32.dll

Vedi anche

WSAAsyncGetProtoByNumber

Funzioni Winsock

Informazioni di riferimento su Winsock

getprotobyname