Funzione WSAGetServiceClassNameByClassIdA (winsock2.h)
La funzione WSAGetServiceClassNameByClassId recupera il nome del servizio associato al tipo specificato. Questo nome è il nome del servizio generico, ad esempio FTP o SNA, e non il nome di un'istanza specifica di tale servizio.
Sintassi
INT WSAAPI WSAGetServiceClassNameByClassIdA(
[in] LPGUID lpServiceClassId,
[out] LPSTR lpszServiceClassName,
[in, out] LPDWORD lpdwBufferLength
);
Parametri
[in] lpServiceClassId
Puntatore al GUID per la classe di servizio.
[out] lpszServiceClassName
Puntatore al nome del servizio.
[in, out] lpdwBufferLength
In input, la lunghezza del buffer restituita da lpszServiceClassName, in caratteri. In output, la lunghezza del nome del servizio copiata in lpszServiceClassName, in caratteri.
Valore restituito
La funzione WSAGetServiceClassNameByClassId restituisce un valore pari a zero se ha esito positivo. In caso contrario, il valore SOCKET_ERROR viene restituito e un numero di errore specifico può essere recuperato chiamando WSAGetLastError.
| Codice di errore | Significato |
|---|---|
| Il parametro lpServiceClassId specificato non è valido. | |
| Memoria insufficiente per eseguire l'operazione. | |
| La routine chiamante non dispone di privilegi sufficienti per accedere alle informazioni. | |
| Il buffer specificato a cui punta da lpszServiceClassName è troppo piccolo. Passare un buffer più grande. | |
| Nessun spazio buffer disponibile. | |
| L'operazione non è supportata per il tipo di oggetto a cui viene fatto riferimento. Questo errore viene restituito da alcuni provider di spazi dei nomi che non supportano l'acquisizione di informazioni sulla classe di servizio. | |
| LpServiceClassId è valido, ma non sono stati trovati dati del tipo richiesto. | |
| La WS2_32.DLL non è stata inizializzata. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Windows Sockets. |
Commenti
Nota
L'intestazione winsock2.h definisce WSAGetServiceClassNameByClassId come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winsock2.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |