funzione getservbyname (winsock2.h)
La funzione getservbyname recupera le informazioni del servizio corrispondenti a un nome e protocollo del servizio.
Sintassi
servent *WSAAPI getservbyname(
[in] const char *name,
[in] const char *proto
);
Parametri
[in] name
Puntatore a un nome del servizio con terminazione null.
[in] proto
Puntatore a un nome di protocollo con terminazione null. Se questo puntatore è NULL, la funzione getservbyname restituisce la prima voce del servizio in cui il nome corrisponde al membro s_name della struttura servent o al membro s_aliases della struttura servent . In caso contrario, getservbyname corrisponde sia al nome che al proto.
Valore restituito
Se non si verifica alcun errore, getservbyname 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. | |
| Una chiamata di Windows Socket 1.1 bloccata è stata annullata tramite WSACancelBlockingCall. |
Commenti
La funzione getservbyname restituisce un puntatore alla struttura servent contenente i nomi e il numero di servizio corrispondenti alla stringa nel parametro name . Tutte le stringhe vengono terminate con valori Null.
Puntatore restituito alla struttura servent allocata dalla libreria 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 | winsock2.h (include Winsock2.h) |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |