Fungsi panggilan balik SpAddCredentialsFn (ntsecpkg.h)

Digunakan untuk menambahkan kredensial untuk prinsip keamanan.

Sintaks

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
)
{...}

Parameter

[in] CredentialHandle

Handel ke kredensial untuk ditambahkan.

[in] PrincipalName

Opsional. Penunjuk ke struktur UNICODE_STRING yang berisi nama prinsip keamanan yang kredensialnya ditambahkan.

[in] Package

Penunjuk ke struktur UNICODE_STRING yang berisi nama paket autentikasi.

[in] CredentialUseFlags

Bendera yang menunjukkan bagaimana kredensial akan digunakan. Nilai berikut ini valid.

Nilai Makna
SECPKG_CRED_INBOUND
Kredensial akan digunakan dengan fungsi AcceptSecurityContext (Umum).
SECPKG_CRED_OUTBOUND
Kredensial akan digunakan dengan fungsi InitializeSecurityContext (Umum).

[in] AuthorizationData

Opsional. Arahkan ke data autentikasi tambahan.

GetKeyFunciton

[in] GetKeyArgument

Penunjuk ke argumen yang digunakan dengan fungsi GetKeyFunction .

[out] ExpirationTime

Penunjuk ke Tanda Waktu yang menerima waktu penanganan kredensial kedaluwarsa.

Mengembalikan nilai

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya.

Keterangan

SSP/APs harus mengimplementasikan fungsi SpAddCredentials ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.

Penunjuk ke fungsi SpAddCredentials tersedia dalam struktur SECPKG_FUNCTION_TABLE yang diterima dari fungsi SpLsaModeInitialize .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecpkg.h

Lihat juga

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize