Funzione WSCInstallNameSpaceEx32 (ws2spi.h)
La funzione WSCInstallNameSpaceEx32 installa un provider di spazi dei nomi a 32 bit specificato. Per i provider in grado di supportare più spazi dei nomi, questa funzione deve essere chiamata per ogni spazio dei nomi supportato e ogni volta deve essere fornito un identificatore univoco del provider.
Sintassi
INT WSCInstallNameSpaceEx32(
[in] LPWSTR lpszIdentifier,
[in] LPWSTR lpszPathName,
[in] DWORD dwNameSpace,
[in] DWORD dwVersion,
[in] LPGUID lpProviderId,
[in] LPBLOB lpProviderSpecific
);
Parametri
[in] lpszIdentifier
Puntatore a una stringa che identifica il provider associato all'identificatore univoco globale (GUID) passato nel parametro lpProviderId .
[in] lpszPathName
Puntatore a una stringa Unicode che contiene il percorso di caricamento della DLL del provider. Questa stringa osserva le regole consuete per la risoluzione del percorso e può contenere stringhe di ambiente incorporate, ad esempio %SystemRoot%. Tali stringhe di ambiente vengono espanse quando il Ws2_32.dll deve successivamente caricare la DLL del provider per conto di un'applicazione. Dopo l'espansione di tutte le stringhe di ambiente incorporate, il Ws2_32.dll passa la stringa risultante alla funzione LoadLibrary che carica il provider in memoria. Per altre informazioni, vedere LoadLibrary.
[in] dwNameSpace
Spazio dei nomi supportato da questo provider.
[in] dwVersion
Numero di versione del provider.
[in] lpProviderId
Puntatore a un GUID per il provider. Questo GUID deve essere generato da Uuidgen.exe.
[in] lpProviderSpecific
BLOB di dati specifico del provider associato alla voce dello spazio dei nomi.
Valore restituito
Se non si verifica alcun errore, la funzione WSCInstallNameSpaceEx32 restituisce NO_ERROR (zero). In caso contrario, restituisce SOCKET_ERROR se la funzione ha esito negativo ed è necessario recuperare il codice di errore appropriato usando la funzione WSAGetLastError .
| Codice di errore | Significato |
|---|---|
| La routine chiamante non dispone di privilegi sufficienti per installare uno spazio dei nomi. | |
| Uno o più argomenti non sono validi. | |
| Si è verificato un errore irreversibile. Questo errore viene restituito in diverse condizioni, tra cui quanto segue: il provider è già installato, l'utente non dispone dei privilegi amministrativi necessari per scrivere nel Registro di sistema Winsock o si è verificato un errore durante la creazione o l'installazione di una voce del catalogo. | |
| Chiamata di sistema che non dovrebbe mai avere esito negativo. | |
| Memoria insufficiente disponibile. Questo errore viene restituito quando la memoria non è sufficiente per allocare una nuova voce del catalogo. |
Commenti
WSCInstallNameSpaceEx32 è una versione a 32 bit di WSCInstallNameSpaceEx. In un computer a 64 bit tutte le chiamate non sono specifiche a 32 bit (ad esempio, tutte le funzioni che non terminano in "32") operano sul catalogo nativo a 64 bit. I processi eseguiti in un computer a 64 bit devono usare le chiamate di funzione a 32 bit specifiche per operare su un catalogo a 32 bit e mantenere la compatibilità. Le definizioni e la semantica delle chiamate a 32 bit specifiche sono le stesse delle rispettive controparti native.
Le funzioni di configurazione dello spazio dei nomi non influiscono sulle applicazioni già in esecuzione. I provider di spazio dei nomi appena installati non saranno visibili alle applicazioni né le modifiche apportate allo stato di attivazione di un provider dello spazio dei nomi. Le applicazioni avviate dopo la chiamata a WSCInstallNameSpaceEx32 vedranno le modifiche.
Il BLOB di dati specifico del provider associato alla voce dello spazio dei nomi passato nel parametro lpProviderInfo può essere sottoposto a query usando la funzione WSCEnumNameSpaceProvidersEx32 .
Attualmente, l'unico provider dello spazio dei nomi incluso in Windows che usa il parametro lpProviderInfo è il provider NS_EMAIL. Il formato del buffer a cui punta il parametro lpProviderInfo per un provider di spazi dei nomi NS_EMAIL è una struttura NAPI_PROVIDER_INSTALLATION_BLOB .
La funzione WSCInstallNameSpaceEx32può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se WSCInstallNameSpaceEx32 viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo. Per i computer in esecuzione in Windows Vista o Windows Server 2008, questa funzione può avere esito negativo anche a causa del controllo dell'account utente. Se un'applicazione che contiene questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel impostato su requireAdministrator. Se l'applicazione in Windows Vista o Windows Server 2008 non dispone di questo file manifesto, un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) affinché questa funzione abbia esito positivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |