Fungsi ChangeAccountPasswordA (sspi.h)

Artikel
03/08/2023

Fungsi ChangeAccountPassword mengubah kata sandi untuk akun domain Windows dengan menggunakan Penyedia Dukungan Keamanan yang ditentukan.

Fungsi ini hanya didukung oleh penyedia Microsoft Kerberos, Microsoft Negosiasi, dan Microsoft NTLM .

Sintaks

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordA(
  [in]      SEC_CHAR       *pszPackageName,
  [in]      SEC_CHAR       *pszDomainName,
  [in]      SEC_CHAR       *pszAccountName,
  [in]      SEC_CHAR       *pszOldPassword,
  [in]      SEC_CHAR       *pszNewPassword,
  [in]      BOOLEAN        bImpersonating,
  [in]      unsigned long  dwReserved,
  [in, out] PSecBufferDesc pOutput
);

Parameter

[in] pszPackageName

Nama penyedia yang akan digunakan. Nilai parameter ini harus "Kerberos", "Negosiasi", atau "NTLM".

[in] pszDomainName

Domain akun untuk mengubah kata sandi.

[in] pszAccountName

Nama pengguna akun untuk mengubah kata sandi.

[in] pszOldPassword

Kata sandi lama yang akan diubah.

[in] pszNewPassword

Kata sandi baru untuk akun yang ditentukan.

[in] bImpersonating

TRUE jika proses panggilan berjalan sebagai klien; jika tidak, FALSE.

[in] dwReserved

Dicadangkan. Harus diatur ke nol.

[in, out] pOutput

Pada input, penunjuk ke struktur SecBufferDesc . Struktur SecBufferDesc harus berisi satu buffer jenis SECBUFFER_CHANGE_PASS_RESPONSE. Pada output, anggota pvBuffer dari struktur tersebut menunjuk ke struktur DOMAIN_PASSWORD_INFORMATION .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan.

Keterangan

Catatan

Header sspi.h mendefinisikan ChangeAccountPassword sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	sspi.h
Pustaka	Secur32.lib
DLL	Secur32.dll