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

SpAcceptLsaModeContext の呼び出しの処理中にトークンを作成します。

構文

LSA_CREATE_TOKEN_EX LsaCreateTokenEx;

NTSTATUS LsaCreateTokenEx(
  [in]  PLUID LogonId,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  [in]  PVOID TokenInformation,
  [in]  PTOKEN_GROUPS TokenGroups,
  [in]  PUNICODE_STRING Workstation,
  [in]  PUNICODE_STRING ProfilePath,
  [in]  PVOID SessionInformation,
  [in]  SECPKG_SESSIONINFO_TYPE SessionInformationType,
  [out] PHANDLE Token,
  [out] PNTSTATUS SubStatus
)
{...}

パラメーター

[in] LogonId

新しいトークンのログオン セッション識別子へのポインター。 この識別子は、 CreateLogonSession の以前の呼び出しから取得されます。

[in] TokenSource

このトークンのソースを指定する TOKEN_SOURCE 構造体へのポインター。 パッケージ名を指定します。

[in] LogonType

ログオンの種類を示す SECURITY_LOGON_TYPE 値。

[in] ImpersonationLevel

サーバー プロセスがクライアント プロセスを偽装できるエクステントを示す SECURITY_IMPERSONATION_LEVEL 値。

[in] TokenInformationType

TokenInformation パラメーターの構造体の型を指定します。

値	意味
LsaTokenInformationNull	LSA_TOKEN_INFORMATION_NULL
LsaTokenInformationV1	LSA_TOKEN_INFORMATION_V1

[in] TokenInformation

トークン情報へのポインター。 TokenInformation によって指される構造体の型は、TokenInformationType パラメーターによって示されます。

[in] TokenGroups

TokenInformation に含まれていないグループを指定するTOKEN_GROUPS構造体へのポインター。

[in] Workstation

クライアントのワークステーションの名前 (通常は NetBIOS 名) を含む UNICODE_STRING構造体への ポインター。

[in] ProfilePath

ユーザーのプロファイルへのパスを含む UNICODE_STRING 構造体へのポインター (存在する場合)。

[in] SessionInformation

現在のログオン セッションに関する情報を指定するデータ。 このデータの形式は、 SessionInformationType パラメーターの値によって指定されます。

[in] SessionInformationType

SessionInformation パラメーターの形式を指定するSECPKG_SESSIONINFO_TYPE列挙の値。 現在、定義されている値は SecSessionPrimaryCred のみです。 これは、SessionInformation パラメーターの値が SECPKG_PRIMARY_CRED 構造体であることを指定します。

[out] Token

新しいトークンへのハンドルのアドレスを受け取るポインター。 ハンドルの使用が完了したら、 CloseHandle 関数を呼び出して閉じます。

[out] SubStatus

エラー情報を受け取る変数へのポインター。

戻り値

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は失敗した理由を示す NTSTATUS コードです。

注釈

CreateTokenEx 関数へのポインターは、SpInitialize 関数によって受信されたLSA_SECPKG_FUNCTION_TABLE構造体で使用できます。

要件

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

こちらもご覧ください

SpInitialize