SspiGetCredUIContext 函数 (sspi.h)

  • 项目

从凭据提供程序检索上下文信息。

语法

SECURITY_STATUS SEC_ENTRY SspiGetCredUIContext(
  [in]  HANDLE                           ContextHandle,
  [in]  GUID                             *CredType,
  [in]  LUID                             *LogonId,
  [out] PSEC_WINNT_CREDUI_CONTEXT_VECTOR *CredUIContexts,
  [out] HANDLE                           *TokenHandle
);

参数

[in] ContextHandle

指向在上一次调用 SspiUnmarshalCredUIContext 函数期间检索到的 SEC_WINNT_CREDUI_CONTEXT 结构的指针。

[in] CredType

由 ContextHandle 参数指定的凭据的类型。 这可以是以下值之一。

值 含义
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD
0x28bfc32f、0x10f6、0x4738、0x98、0xd1、0x1a、0xc0、0x61、0xdf、0x71、0x6a
 凭据是密码。
SEC_WINNT_AUTH_DATA_TYPE_CERT
0x235f69ad、0x73fb、0x4dbc、0x82、0x3、0x6、0x29、0xe7、0x39、0x33、0x9b
 凭据是证书。
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA
0x68fd9879、0x79c、0x4dfe、0x82、0x81、0x57、0x8a、0xad、0xc1、0xc1、0x0
 凭据是 来自加密服务提供程序 (CSP) 的身份验证数据。

[in] LogonId

与 ContextHandle 参数指定的凭据关联的登录 ID。

调用方必须以 LocalSystem 身份运行才能指定登录 ID。

[out] CredUIContexts

指向 SEC_WINNT_CREDUI_CONTEXT_VECTOR 结构的指针，该结构指定 由 ContextHandle 参数指定的结构中的数据的偏移量和大小。

[out] TokenHandle

指定用户令牌的句柄。

返回值

如果该函数成功，则返回 SEC_E_OK。

如果函数失败，它将返回非零错误代码。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 sspi.h
Library Credui.lib
DLL Credui.dll