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

TOKEN_GROUPS 結構的指標,指定 TokenInformation 中未包含的群組。

[in] Workstation

包含用戶端工作站名稱 的UNICODE_STRING 結構的指標,通常是 NetBIOS 名稱。

[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