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
WSANOTINITIALISED	Prima di usare questa funzione, è necessario eseguire una chiamata WSAStartup riuscita.
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAHOST_NOT_FOUND	Servizio risposte autorevole non trovato.
WSATRY_AGAIN	Un servizio non autenticativo non trovato o un errore del server.
WSANO_RECOVERY	Errori non recuperabili, il database dei servizi non è accessibile.
WSANO_DATA	Nome valido, nessun record di dati del tipo richiesto.
WSAEINPROGRESS	Una chiamata windows Sockets 1.1 bloccata è in corso oppure il provider di servizi sta ancora elaborando una funzione di callback.
WSAEFAULT	Il parametro proto non è una parte valida dello spazio indirizzi utente.
WSAEINTR	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

Vedi anche

WSAAsyncGetServByPort

Funzioni Winsock

Informazioni di riferimento su Winsock

getservbyname