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.

Sintassi

INT WSAAPI WSAGetServiceClassNameByClassIdW(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPWSTR  lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Parametri

[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.

Valore restituito

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
WSA_INVALID_PARAMETER
Il parametro lpServiceClassId specificato non è valido.
WSA_NOT_ENOUGH_MEMORY
Memoria insufficiente per eseguire l'operazione.
WSAEACCES
La routine chiamante non dispone di privilegi sufficienti per accedere alle informazioni.
WSAEFAULT
Il buffer specificato a cui punta lpszServiceClassName è troppo piccolo. Passare un buffer più grande.
WSAENOBUFS
Non è disponibile spazio buffer.
WSAEOPNOTSUPP
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.
WSANO_DATA
LpServiceClassId è valido, ma non sono stati trovati dati del tipo richiesto.
WSANOTINITIALISED
Il WS2_32.DLL non è stato inizializzato. L'applicazione deve prima chiamare WSAStartup prima di chiamare qualsiasi funzione Di 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 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.

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

Vedi anche

WSAStartup

Funzioni Winsock

Informazioni di riferimento su Winsock