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 (General) 函式使用。
SECPKG_CRED_OUTBOUND
 認證將搭配 InitializeSecurityContext (General) 函式使用。

[in] AuthorizationData

選擇性。 補充驗證數據的指標。

GetKeyFunciton

[in] GetKeyArgument

搭配 GetKeyFunction 函式使用的自變數指標。

[out] ExpirationTime

接收認證句柄到期時間的 TimeStamp 指標。

傳回值

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

如果函式失敗，則傳回 NTSTATUS 程式代碼，指出失敗的原因。

備註

SSP/AP 必須實作 SpAddCredentials 函式;不過，提供給實作的實際名稱會由開發人員決定。

SpAddCredentials 函式的指標可在從 SpLsaModeInitialize 函式接收的 SECPKG_FUNCTION_TABLE 結構中使用。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecpkg.h

另請參閱

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize