Funzione getprotobyname (winsock2.h)
La funzione getprotobyname recupera le informazioni sul protocollo corrispondenti a un nome di protocollo.
Sintassi
protoent *WSAAPI getprotobyname(
[in] const char *name
);
Parametri
[in] name
Puntatore a un nome di protocollo con terminazione Null.
Valore restituito
Se non si verifica alcun errore, getprotobyname restituisce un puntatore al protoente. In caso contrario, restituisce un puntatore Null e un numero di errore specifico può essere recuperato chiamando WSAGetLastError.
| Codice di errore | Significato |
|---|---|
| Prima di usare questa funzione, è necessario che venga eseguita una chiamata WSAStartup riuscita. | |
| Il sottosistema di rete non è riuscito. | |
| Protocollo di risposta autorevole non trovato. | |
| Impossibile trovare un protocollo non autenticativo o un errore del server. | |
| Errori irreversibili, il database dei protocolli non è accessibile. | |
| Nome valido, nessun record di dati di tipo richiesto. | |
| È in corso una chiamata di Windows Sockets 1.1 bloccante oppure il provider di servizi sta ancora elaborando una funzione di callback. | |
| Il parametro name non è una parte valida dello spazio indirizzi utente. | |
| Una chiamata di Windows Socket 1.1 bloccata è stata annullata tramite WSACancelBlockingCall. |
Commenti
La funzione getprotobyname restituisce un puntatore alla struttura protoent contenente i nomi e il numero di protocollo corrispondenti al protocollo specificato nel parametro name . Tutte le stringhe sono con terminazione Null. La struttura protoent viene allocata dalla libreria Windows Sockets. Un'applicazione non deve mai tentare di modificare questa struttura o di liberare i relativi componenti. Inoltre, come hostent, 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 |