IADsUser::ChangePassword method (iads.h)

Metode IADsUser::ChangePassword mengubah kata sandi pengguna dari nilai lama yang ditentukan menjadi nilai baru.

Sintaks

HRESULT ChangePassword(
  [in]  BSTR bstrOldPassword,
  [out] BSTR bstrNewPassword
);

Parameter

[in] bstrOldPassword

BSTR yang berisi kata sandi saat ini.

[out] bstrNewPassword

BSTR yang berisi kata sandi baru.

Nilai kembali

Metode ini mendukung nilai pengembalian standar, termasuk S_OK. Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

IADsUser::ChangePassword berfungsi mirip dengan IADsUser::SetPassword karena akan menggunakan salah satu dari tiga metode untuk mencoba mengubah kata sandi. Awalnya, penyedia LDAP akan mencoba operasi perubahan kata sandi LDAP, jika koneksi SSL aman ke server dibuat. Jika upaya ini gagal, penyedia LDAP selanjutnya akan mencoba menggunakan Kerberos (lihat IADsUser::SetPassword untuk beberapa masalah yang dapat mengakibatkan Windows dengan autentikasi lintas forest), dan jika ini juga gagal, akhirnya akan memanggil API manajemen jaringan khusus Active Directory, NetUserChangePassword.

Di Direktori Aktif, pemanggil harus memiliki hak akses kontrol ubah kata sandi yang diperluas untuk mengubah kata sandi dengan metode ini.

Contoh

Contoh kode berikut menunjukkan cara mengubah kata sandi pengguna.

Dim usr As IADsUser
Dim szOldPass As String
Dim szNewPass As String

On Error GoTo Cleanup

Set usr = GetObject("WinNT://Fabrikam/JeffSmith,user")
' Add code to securely retrieve the old and new password.

usr.ChangePassword szOldPass, szNewPass

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set usr = Nothing

Contoh kode berikut menunjukkan cara mengubah kata sandi pengguna.

HRESULT ChangePassword(
    IADsUser *pUser, 
    LPWSTR oldPasswd, 
    LPWSTR newPasswd)
{
    HRESULT hr=S_OK;
    if(!pUser) { return E_FAIL;}
    hr = pUser->ChangePassword(oldPasswd, newPasswd);
    printf("User password has been changed");
    return hr;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll

Lihat juga

Kode Kesalahan ADSI

IADsUser

Metode Properti IADsUser