SpAddCredentialsFn 回调函数 (ntsecpkg.h)

用于添加安全主体凭据

语法

SpAddCredentialsFn Spaddcredentialsfn;

NTSTATUS Spaddcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  PUNICODE_STRING PrincipalName,
  [in]  PUNICODE_STRING Package,
  [in]  ULONG CredentialUseFlags,
  [in]  PVOID AuthorizationData,
        PVOID GetKeyFunciton,
  [in]  PVOID GetKeyArgument,
  [out] PTimeStamp ExpirationTime
)
{...}

参数

[in] CredentialHandle

要添加的凭据的句柄。

[in] PrincipalName

可选。 指向 UNICODE_STRING 结构的指针,该结构包含要添加其凭据 的安全主体 的名称。

[in] Package

指向包含身份验证包名称 的UNICODE_STRING 结构的指针。

[in] CredentialUseFlags

指示凭据使用方式的标志。 以下值有效。

含义
SECPKG_CRED_INBOUND
凭据将与 AcceptSecurityContext (常规) 函数一起使用。
SECPKG_CRED_OUTBOUND
凭据将与 InitializeSecurityContext (General) 函数一起使用。

[in] AuthorizationData

可选。 指向补充身份验证数据的指针。

GetKeyFunciton

[in] GetKeyArgument

指向与 GetKeyFunction 函数一起使用的参数的指针。

[out] ExpirationTime

指向接收凭据句柄过期时间的 TimeStamp 的指针。

返回值

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

如果函数失败,则返回一个 NTSTATUS 代码,指示它失败的原因。

注解

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

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

要求

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

另请参阅

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize