funzione getservbyport (winsock.h)
La funzione getservbyport recupera le informazioni del servizio corrispondenti a una porta e a un protocollo.
Sintassi
servent * getservbyport(
[in] int port,
[in] const char *proto
);
Parametri
[in] port
Porta per un servizio, in ordine di byte di rete.
[in] proto
Puntatore facoltativo a un nome di protocollo. Se si tratta di null, getservbyport restituisce la prima voce del servizio per cui la porta corrisponde alla s_port della struttura servent . In caso contrario, getservbyport corrisponde sia alla porta che ai parametri proto .
Valore restituito
Se non si verifica alcun errore, getservbyport restituisce un puntatore alla struttura servent . 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 eseguire una chiamata WSAStartup riuscita. | |
| Il sottosistema di rete non è riuscito. | |
| Servizio risposte autorevole non trovato. | |
| Un servizio non autenticativo non trovato o un errore del server. | |
| Errori non recuperabili, il database dei servizi non è accessibile. | |
| Nome valido, nessun record di dati del tipo richiesto. | |
| Una chiamata windows Sockets 1.1 bloccata è in corso oppure il provider di servizi sta ancora elaborando una funzione di callback. | |
| Il parametro proto non è una parte valida dello spazio indirizzi utente. | |
| Una chiamata di Windows Socket 1.1 bloccata è stata annullata tramite WSACancelBlockingCall. |
Commenti
La funzione getservbyport restituisce un puntatore a una struttura servent come fa nella funzione getservbyname .
La struttura servent viene allocata da Windows Sockets. L'applicazione non deve mai tentare di modificare questa struttura o di liberare uno dei relativi componenti. Inoltre, solo una copia di questa struttura viene allocata per thread, quindi l'applicazione deve copiare tutte le informazioni necessarie prima di inviare qualsiasi altra chiamata di funzione Windows Sockets.
Windows Phone 8: questa funzione è supportata per le app Windows Phone Store 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 | winsock.h (include Winsock2.h) |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |