Funzione WSAInstallServiceClassA (winsock2.h)

La funzione WSAInstallServiceClass registra uno schema di classe del servizio all'interno di uno spazio dei nomi. Questo schema include il nome della classe, l'identificatore di classe e le informazioni specifiche dello spazio dei nomi comuni a tutte le istanze del servizio, ad esempio l'identificatore SAP o l'identificatore dell'oggetto.

Sintassi

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Parametri

[in] lpServiceClassInfo

Classe del servizio per le informazioni di mapping specifiche del tipo dello spazio dei nomi. È possibile gestire più mapping contemporaneamente.

Per una descrizione delle strutture di dati pertinenti, vedere la sezione Strutture dei dati della classe di servizio .

Valore restituito

Il valore restituito è zero se l'operazione ha avuto esito positivo. 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 provider dello spazio dei nomi non può fornire le informazioni sulla classe richieste.
WSA_NOT_ENOUGH_MEMORY
Memoria insufficiente per eseguire l'operazione.
WSAEACCES
La funzione chiamante non dispone di privilegi sufficienti per installare il servizio.
WSAEALREADY
Le informazioni sulla classe di servizio sono già state registrate per questo identificatore di classe del servizio. Per modificare le informazioni sulla classe di servizio, usare prima WSARemoveServiceClass e quindi reinstallare con i dati aggiornati sulle informazioni sulle classi.
WSAEINVAL
Le informazioni sulla classe di servizio non sono valide o strutturate in modo non corretto. Questo errore viene restituito se il parametro lpServiceClassInfo è NULL.
WSAEOPNOTSUPP
L'operazione non è supportata. Questo errore viene restituito se il provider dello spazio dei nomi non implementa questa funzione.
WSANO_DATA
Il nome richiesto è 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 WSAInstallServiceClass 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

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winsock2.h
Libreria Ws2_32.lib
DLL Ws2_32.dll

Vedi anche

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Funzioni Winsock

Informazioni di riferimento su Winsock