CredReadFn 回调函数 (ntsecpkg.h)

从凭据 管理器读取凭据

语法

CredReadFn Credreadfn;

NTSTATUS Credreadfn(
  [in]  PLUID LogonId,
  [in]  ULONG CredFlags,
  [in]  LPWSTR TargetName,
  [in]  ULONG Type,
  [in]  ULONG Flags,
  [out] PENCRYPTED_CREDENTIALW *Credential
)
{...}

参数

[in] LogonId

要读取其凭据的登录 ID。

[in] CredFlags

确定此函数行为的标志。 定义了以下标志。

含义
CREDP_FLAGS_IN_PROCESS
0x01
调用方处于进程内。
CREDP_FLAGS_USE_MIDL_HEAP
0x02
调用方应使用 midl_user_allocate 函数来分配 凭据 缓冲区。
CREDP_FLAGS_DONT_CACHE_TI
0x04
不要缓存目标信息。
CREDP_FLAGS_CLEAR_PASSWORD
0x08
凭据数据以明文形式传递。
CREDP_FLAGS_USER_ENCRYPTED_PASSWORD
0x10
凭据数据是使用 RtlEncryptMemory 函数加密的。
CREDP_FLAGS_TRUSTED_CALLER
0x20
调用方是受信任的进程。

[in] TargetName

目标计算机的名称。

[in] Type

指定要读取的凭据的类型。 此参数的可能值与 CREDENTIAL 结构的 Type 成员的可能值相同。

[in] Flags

保留。 该参数必须设置为零。

[out] Credential

指向 ENCRYPTED_CREDENTIALW 结构的指针 的指针,该结构接收此函数读取的凭据。

返回值

如果函数成功,则返回STATUS_SUCCESS或信息性状态代码。

如果函数失败,则返回 NTSTATUS 错误代码,指示失败的原因。

注解

SpInitialize 函数接收的 LSA_SECPKG_FUNCTION_TABLE 结构中提供了指向 CrediRead 函数的指针。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecpkg.h

另请参阅

SpInitialize