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 參數中的結構類型。
值 | 意義 |
---|---|
|
|
|
[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 |