Condividi tramite

Funzione SaferCreateLevel (winsafer.h)

  • Articolo

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)