Export (0) Print
Expand All

SaferCreateLevel function

The SaferCreateLevel function opens a SAFER_LEVEL_HANDLE.

Syntax


BOOL WINAPI SaferCreateLevel(
  _In_        DWORD dwScopeId,
  _In_        DWORD dwLevelId,
  _In_        DWORD OpenFlags,
  _Out_       SAFER_LEVEL_HANDLE *pLevelHandle,
  _Reserved_  LPVOID lpReserved
);

Parameters

dwScopeId [in]

The scope of the level to be created. The following table shows the possible values.

ValueMeaning
SAFER_SCOPEID_MACHINE
1

The scope of the created level is by computer.

SAFER_SCOPEID_USER
2

The scope of the created level is by user.

 

dwLevelId [in]

The level of the handle to be opened. The following table shows the possible values.

ValueMeaning
SAFER_LEVELID_CONSTRAINED
0x10000

Software cannot access certain resources, such as cryptographic keys and credentials, regardless of the user rights of the user.

SAFER_LEVELID_DISALLOWED
0x00000

Software will not run, regardless of the user rights of the user.

SAFER_LEVELID_FULLYTRUSTED
0x40000

Software user rights are determined by the user rights of the user.

SAFER_LEVELID_NORMALUSER
0x20000

Allows programs to execute as a user that does not have Administrator or Power User user rights. Software can access resources accessible by normal users.

SAFER_LEVELID_UNTRUSTED
0x01000

Allows programs to execute with access only to resources granted to open well-known groups, blocking access to Administrator and Power User privileges and personally granted rights.

 

OpenFlags [in]

This can be the following value.

ValueMeaning
SAFER_LEVEL_OPEN
1

 

pLevelHandle [out]

The returned SAFER_LEVEL_HANDLE. When you have finished using the handle, close it by calling the SaferCloseLevel function.

lpReserved

This parameter is reserved for future use. Set it to NULL.

Return value

Returns nonzero if successful or zero otherwise.

For extended error information, call GetLastError.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinSafer.h

Library

Advapi32.lib

DLL

Advapi32.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft