SpGetCredentialsFn 回调函数 (ntsecpkg.h)

SpGetCredentials 函数从用户对象中检索主要凭据和补充凭据。

语法

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

[in] CredentialHandle

要检索的凭据的句柄。

[out] Credentials

指向接收凭据的 SecBuffer 结构的指针。

如果函数成功，则返回STATUS_SUCCESS。

如果函数失败，则返回 NTSTATUS 代码，指示失败的原因。下面列出了失败的常见原因以及函数应返回的错误代码。

返回代码	说明
SEC_E_INSUFFICIENT_MEMORY	内存不足，无法检索凭据。
SEC_E_INVALID_HANDLE	句柄无效。

SSP/AP 必须实现 SpGetCredentials 函数;但是，为实现提供的实际名称由开发人员决定。

从 SpLsaModeInitialize 函数接收的 SECPKG_FUNCTION_TABLE 结构中提供了指向 SpGetCredentials 函数的指针。