DuplicateToken

既存のアクセストークンを複製して新しいアクセストークンを作成する。

DuplicateToken ExistingTokenHandle, ImpersonationLevel, DuplicateTokenHandle

ExistingTokenHandle : [intptr] TOKEN_DUPLICATE アクセスで開いたアクセストークンへのハンドル。
ImpersonationLevel : [int] 新しいトークンの偽装レベルを指定する SECURITY_IMPERSONATION_LEVEL 列挙型を指定する。
DuplicateTokenHandle : [intptr] 複製されたトークンへのハンドルを受け取る変数へのポインタ。このハンドルは新しいトークンに対して TOKEN_IMPERSONATE および TOKEN_QUERY のアクセス権を持つ。新しいトークンの使用が終わったら、CloseHandle 関数を呼び出してトークンハンドルを閉じる。

(プラグイン / モジュール : advapi32.dll)

解説

既存のアクセストークンを複製して新しいアクセストークンを作成する。

[戻り値]
関数が成功した場合、戻り値はゼロ以外となる。失敗した場合、戻り値はゼロとなる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
DuplicateToken 関数は偽装トークンを作成し、SetThreadToken や ImpersonateLoggedOnUser
などの関数で使用できる。DuplicateToken で作成したトークンは、プライマリトークンを必要とする
CreateProcessAsUser 関数では使用できない。CreateProcessAsUser
に渡せるトークンを作成するには、DuplicateTokenEx 関数を使用する。

情報