Funzione WSAInstallServiceClassA (winsock2.h)
La funzione WSAInstallServiceClass registra uno schema della classe del servizio all'interno di uno spazio dei nomi. Questo schema include il nome della classe, l'identificatore di classe e tutte le informazioni specifiche dello spazio dei nomi comuni a tutte le istanze del servizio, ad esempio l'identificatore SAP o l'identificatore di oggetto.
Sintassi
INT WSAAPI WSAInstallServiceClassA(
[in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);
Parametri
[in] lpServiceClassInfo
Classe di servizio per informazioni sul mapping di tipo specifico dello spazio dei nomi. È possibile gestire più mapping contemporaneamente.
Vedere la sezione Service Class Data Structures per una descrizione delle strutture di dati pertinenti.
Valore restituito
Il valore restituito è zero se l'operazione ha avuto 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 |
|---|---|
| Il provider dello spazio dei nomi non può fornire le informazioni sulla classe richiesta. | |
| Memoria insufficiente per eseguire l'operazione. | |
| La funzione chiamante non dispone di privilegi sufficienti per installare il servizio. | |
| Le informazioni sulla classe del servizio sono già state registrate per questo identificatore di classe del servizio. Per modificare le informazioni sulla classe del servizio, usare prima di tutto WSARemoveServiceClasse quindi reinstallare con i dati aggiornati sulle informazioni sulla classe. | |
| Le informazioni sulla classe del servizio non sono valide o strutturate in modo non corretto. Questo errore viene restituito se il parametro lpServiceClassInfo è NULL. | |
| L'operazione non è supportata. Questo errore viene restituito se il provider dello spazio dei nomi non implementa questa funzione. | |
| Il nome richiesto è 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 Windows Sockets. |
Osservazioni
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 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 [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
winsock2.h |
| libreria |
Ws2_32.lib |
| dll | Ws2_32.dll |
Vedere anche
WSAGetServiceClassInfo
WSASERVICECLASSINFO