Funzione SaferCreateLevel (winsafer.h)

La funzione SaferCreateLevel apre un SAFER_LEVEL_HANDLE.

Sintassi

BOOL SaferCreateLevel(
  [in]  DWORD              dwScopeId,
  [in]  DWORD              dwLevelId,
  [in]  DWORD              OpenFlags,
  [out] SAFER_LEVEL_HANDLE *pLevelHandle,
        LPVOID             lpReserved
);

Parametri

[in] dwScopeId

Ambito del livello da creare. Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
SAFER_SCOPEID_MACHINE 1	L'ambito del livello creato è per computer.
SAFER_SCOPEID_USER 2	L'ambito del livello creato è da parte dell'utente.

[in] dwLevelId

Livello dell'handle da aprire. Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
SAFER_LEVELID_CONSTRAINED 0x10000	Il software non può accedere a determinate risorse, ad esempio chiavi crittografiche e credenziali, indipendentemente dai diritti utente dell'utente.
SAFER_LEVELID_DISALLOWED 0x00000	Il software non verrà eseguito, indipendentemente dai diritti utente dell'utente.
SAFER_LEVELID_FULLYTRUSTED 0x40000	I diritti utente software sono determinati dai diritti utente dell'utente.
SAFER_LEVELID_NORMALUSER 0x20000	Consente ai programmi di eseguire come utente che non dispone dei diritti utente amministratore o utente di Power User . Il software può accedere alle risorse accessibili dagli utenti normali.
SAFER_LEVELID_UNTRUSTED 0x01000	Consente l'esecuzione dei programmi con accesso solo alle risorse concesse per aprire gruppi noti, bloccando l'accesso a privilegi amministratore e Power User e concedendo i diritti personali.

[in] OpenFlags

Questo può essere il valore seguente.

Valore	Significato
SAFER_LEVEL_OPEN 1

[out] pLevelHandle

SAFER_LEVEL_HANDLE restituito. Al termine dell'uso dell'handle, chiuderlo chiamando la funzione SaferCloseLevel .

lpReserved

Questo parametro è riservato per usi futuri. Impostarlo su NULL.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Per informazioni sull'errore estese, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsafer.h
Libreria	Advapi32.lib
DLL	Advapi32.dll
Set di API	ext-ms-win-advapi32-safer-l1-1-0 (introdotto in Windows 8)