SpGetContextTokenFn 回呼函式 (ntsecpkg.h)

  • 發行項

取得要仿真的令牌。 SSPI ImpersonateSecurityContext 函式會使用 SpGetContextToken 函式來取得要仿真的令牌。

語法

SpGetContextTokenFn Spgetcontexttokenfn;

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

參數

[in] ContextHandle

要模擬之內容的句柄。

[out] ImpersonationToken

接收指定內容之標記句柄的指標。 將句柄傳回令牌，而不先複製句柄或令牌。

傳回值

如果函式成功，則傳回STATUS_SUCCESS。

如果函式失敗，則傳回 NTSTATUS 程式代碼，指出失敗的原因。 下列列出失敗的常見原因，以及函式應該傳回的錯誤碼。

傳回碼 Description
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