Funzione WSAGetServiceClassNameByClassIdA (winsock2.h)

Articolo
11/20/2024

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 WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   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 caso di input, la lunghezza del buffer restituito da lpszServiceClassName, in caratteri. In output, la lunghezza del nome del servizio copiato in lpszServiceClassName, in caratteri.

Valore restituito

La funzione WSAGetServiceClassNameByClassId restituisce un valore pari a zero se ha esito positivo. In caso contrario, viene restituito il valore SOCKET_ERROR e un numero di errore specifico può essere recuperato 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	Nessun spazio disponibile nel buffer.
WSAEOPNOTSUPP	L'operazione non è supportata per il tipo di oggetto a cui si fa riferimento. Questo errore viene restituito da alcuni provider di spazi dei nomi che non supportano l'acquisizione di informazioni sulla classe del servizio.
WSANO_DATA	Il 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 Windows Sockets.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	winsock2.h
libreria	Ws2_32.lib
dll	Ws2_32.dll

Vedere anche

WSAStartup

Funzioni Winsock

di riferimento winsock

Condividi tramite