Eventi
Funzione WSAGetServiceClassNameByClassIdW (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 del servizio.
INT WSAAPI WSAGetServiceClassNameByClassIdW(
[in] LPGUID lpServiceClassId,
[out] LPWSTR lpszServiceClassName,
[in, out] LPDWORD lpdwBufferLength
);
[in] lpServiceClassId
Puntatore al GUID per la classe del servizio.
[out] lpszServiceClassName
Puntatore al nome del servizio.
[in, out] lpdwBufferLength
In input, la lunghezza del buffer restituita da lpszServiceClassName, in caratteri. Nell'output la lunghezza del nome del servizio copiata in lpszServiceClassName, espressa in caratteri.
Se l'operazione riesce, la funzione WSAGetServiceClassNameByClassId restituisce un valore pari a zero. In caso contrario, viene restituito il valore SOCKET_ERROR e è possibile recuperare un numero di errore specifico 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 lpszServiceClassName è troppo piccolo. Passare un buffer più grande. | |
Non è disponibile spazio buffer. | |
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 il recupero delle informazioni sulla classe del servizio. | |
LpServiceClassId è valido, ma non sono stati trovati dati del tipo richiesto. | |
Il WS2_32.DLL non è stato inizializzato. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Di Windows Sockets. |
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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 |