The OpenProcessToken function opens the access token associated with a process.
Declare Function OpenProcessToken Lib "advapi32.dll" Alias "OpenProcessToken" (ByVal ProcessHandle As Long, ByVal DesiredAccess As Long, TokenHandle As Long) As Long
|Operating Systems Supported|
|Requires Windows NT 3.1 or later; Win9x/ME: Not supported|
Identifies the process whose access token is opened.
Specifies an access mask that specifies the requested types of access to the access token. These requested access types are compared with the tokenís discretionary access-control list (ACL) to determine which accesses are granted or denied. The following access rights have been defined for access tokens.
Required to change the default ACL, primary group, or owner of an access token.
Required to change the groups specified in an access token.
Required to change the privileges specified in an access token.
Combines the STANDARD_RIGHTS_REQUIRED standard access rights and all individual access rights for tokens.
Required to attach a primary token to a process in addition to the SE_CREATE_TOKEN_NAME privilege.
Required to duplicate an access token.
Combines the STANDARD_RIGHTS_EXECUTE standard access rights and the TOKEN_IMPERSONATE access right.
Required to attach an impersonation access token to a process.
Required to query the contents of an access token.
Required to query the source of an access token.
Combines the STANDARD_RIGHTS_READ standard access rights and the TOKEN_QUERY access right.
Combines the STANDARD_RIGHTS_WRITE standard access rights and the TOKEN_ADJUST_PRIVILEGES, TOKEN_ADJUST_GROUPS, and TOKEN_ADJUST_DEFAULT access rights.
Points to a handle identifying the newly-opened access token when the function returns.
|If the function succeeds, the return value is nonzero.|
If the function fails, the return value is zero. To get extended error information, call GetLastError.