Funzione WSCInstallNameSpace32 (ws2spi.h)

La funzione WSCInstallNameSpace32 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 WSCInstallNameSpace32(
  [in] LPWSTR lpszIdentifier,
  [in] LPWSTR lpszPathName,
  [in] DWORD  dwNameSpace,
  [in] DWORD  dwVersion,
  [in] LPGUID lpProviderId
);

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 che contiene il percorso dell'immagine DLL del provider. La stringa osserva le regole consuete per la risoluzione del percorso: questo percorso può contenere stringhe di ambiente incorporate (ad esempio %SystemRoot%). Tali stringhe di ambiente vengono espanse ogni volta che il WS2_32.DLL deve successivamente caricare la DLL del provider per conto di un'applicazione. Dopo aver espanso tutte le stringhe di ambiente incorporate, il Ws2_32.dll passa la stringa risultante nella funzione LoadLibrary per caricare il provider in memoria. Per altre informazioni, vedere LoadLibrary.

[in] dwNameSpace

Descrittore che specifica lo spazio dei nomi supportato da questo provider.

[in] dwVersion

Descrittore che specifica il numero di versione del provider.

[in] lpProviderId

Identificatore univoco per questo provider. Questo GUID deve essere generato da Uuidgen.exe.

Valore restituito

Se non si verifica alcun errore, la funzione WSCInstallNameSpace32 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 .

Commenti

WSCInstallNameSpace32 è una versione a 32 bit di WSCInstallNameSpace. 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 spazi dei nomi appena installati non saranno visibili alle applicazioni né le modifiche apportate allo stato di attivazione di un provider di spazi dei nomi. Le applicazioni avviate dopo la chiamata a WSCInstallNameSpace32 riconosceranno le modifiche.

La funzione WSCInstallNameSpace32 può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se WSCInstallNameSpace32 viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo. Per i computer che eseguono 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

Vedi anche

WSCDeinstallProvider32

WSCEnumProtocols32

WSCInstallNameSpace

WSCInstallNameSpaceEx32

WSCUnInstallNameSpace32