SpGetContextTokenFn コールバック関数 (ntsecpkg.h)

  • [アーティクル]

偽装するトークンを取得します。 SpGetContextToken 関数は、偽装するトークンを取得するために SSPI ImpersonateSecurityContext 関数によって使用されます。

構文

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

パラメーター

[in] ContextHandle

偽装するコンテキストへのハンドル。

[out] ImpersonationToken

指定したコンテキストのトークンへのハンドルを受け取るポインター。 最初にハンドルまたはトークンを複製せずに、トークンにハンドルを返します。

戻り値

関数が成功した場合は、STATUS_SUCCESSを返します。

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。 次に、エラーの一般的な理由と、関数が返すエラー コードを示します。

リターン コード 説明
SEC_E_INVALID_HANDLE
 ハンドルが無効です。

注釈

SSP/AP は SpGetContextToken 関数を実装する必要があります。ただし、実装に与えられる実際の名前は開発者が指定します。

SpGetContextToken 関数へのポインターは、SpUserModeInitialize 関数から受信したSECPKG_USER_FUNCTION_TABLE構造体で使用できます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecpkg.h

こちらもご覧ください

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize