Função SaferCreateLevel (winsafer.h)

A função SaferCreateLevel abre um SAFER_LEVEL_HANDLE.

Sintaxe

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

Parâmetros

[in] dwScopeId

O escopo do nível a ser criado. A tabela a seguir mostra os valores possíveis.

Valor	Significado
SAFER_SCOPEID_MACHINE 1	O escopo do nível criado é por computador.
SAFER_SCOPEID_USER 2	O escopo do nível criado é por usuário.

[in] dwLevelId

O nível do identificador a ser aberto. A tabela a seguir mostra os valores possíveis.

Valor	Significado
SAFER_LEVELID_CONSTRAINED 0x10000	O software não pode acessar determinados recursos, como chaves criptográficas e credenciais, independentemente dos direitos de usuário do usuário.
SAFER_LEVELID_DISALLOWED 0x00000	O software não será executado, independentemente dos direitos de usuário do usuário.
SAFER_LEVELID_FULLYTRUSTED 0x40000	Os direitos de usuário de software são determinados pelos direitos de usuário do usuário.
SAFER_LEVELID_NORMALUSER 0x20000	Permite que os programas sejam executados como um usuário que não tem direitos de usuário administrador ou usuário avançado. O software pode acessar recursos acessíveis por usuários normais.
SAFER_LEVELID_UNTRUSTED 0x01000	Permite que os programas sejam executados com acesso somente aos recursos concedidos para abrir grupos conhecidos, bloqueando o acesso a privilégios de Administrador e Usuário avançado e direitos concedidos pessoalmente.

[in] OpenFlags

Esse pode ser o valor a seguir.

Valor	Significado
SAFER_LEVEL_OPEN 1

[out] pLevelHandle

O SAFER_LEVEL_HANDLE retornado. Quando terminar de usar o identificador, feche-o chamando a função SaferCloseLevel .

lpReserved

Esse parâmetro é reservado para uso futuro. Defina-o como NULL.

Retornar valor

Retornará diferente de zero se tiver êxito ou zero caso contrário.

Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winsafer.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll
Conjunto de APIs	ext-ms-win-advapi32-safer-l1-1-0 (introduzido no Windows 8)