Fungsi SspiUpdateCredentials (sspi.h)

Updates kredensial yang terkait dengan konteks yang ditentukan.

Sintaks

SECURITY_STATUS SEC_ENTRY SspiUpdateCredentials(
  [in] HANDLE ContextHandle,
  [in] GUID   *CredType,
  [in] ULONG  FlatCredUIContextLength,
  [in] PUCHAR FlatCredUIContext
);

Parameter

[in] ContextHandle

Penunjuk ke struktur SEC_WINNT_CREDUI_CONTEXT yang diambil selama panggilan sebelumnya ke fungsi SspiUnmarshalCredUIContext .

[in] CredType

Jenis kredensial yang ditentukan oleh parameter ContextHandle . Ini bisa menjadi salah satu nilai berikut.

Nilai Makna
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD
0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a
Kredensial adalah kata sandi.
SEC_WINNT_AUTH_DATA_TYPE_CERT
0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b
Kredensial adalah sertifikat.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA
0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0
Kredensial adalah data autentikasi dari penyedia layanan kriptografi (CSP).

[in] FlatCredUIContextLength

Ukuran, dalam byte, dari buffer FlatCredUIContext .

[in] FlatCredUIContext

Nilai untuk memperbarui kredensial yang ditentukan.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header sspi.h
Pustaka Credui.lib
DLL Credui.dll