Fungsi DsMakePasswordCredentialsA (ntdsapi.h)

Fungsi DsMakePasswordCredentials membangun handel kredensial yang cocok untuk digunakan dengan fungsi DsBindWithCred.

Sintaksis

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

Parameter

[in] User

Penunjuk ke string null-terminated yang berisi nama pengguna yang akan digunakan untuk kredensial.

[in] Domain

Penunjuk ke string yang dihentikan null yang berisi domain tempat pengguna menjadi anggotanya.

[in] Password

Penunjuk ke string yang dihentikan null yang berisi kata sandi yang akan digunakan untuk kredensial.

[out] pAuthIdentity

Penunjuk ke nilai RPC_AUTH_IDENTITY_HANDLE yang menerima handel kredensial. Handel ini digunakan dalam panggilan berikutnya untuk DsBindWithCred. Handel ini harus dibebaskan dengan fungsi DsFreePasswordCredentials ketika tidak lagi diperlukan.

Mengembalikan nilai

Mengembalikan kode kesalahan Windows, termasuk yang berikut ini.

Komentar

Handel kredensial default null dibuat jikaPengguna , Domain , dan Kata Sandi semuanya NULL . Jika tidak, Pengguna harus ada. Parameter Domain mungkin NULL saat Pengguna sepenuhnya memenuhi syarat, seperti pengguna dalam format UPN; misalnya, "".

Ketika handel yang dikembalikan dalam pAuthIdentity diteruskan ke DsBindWithCred, DsUnBind harus dipanggil sebelum membebaskan handel dengan DsFreePasswordCredentials. Urutan normalnya adalah:

1. Panggil DsMakePasswordCredentials untuk mendapatkan handel kredensial.
2. Panggil DsBindWithCred, dan berikan handel kredensial.
3. Panggil DsUnbind saat pengikatan tidak lagi diperlukan.
4. Panggil DsFreePasswordCredentials untuk membebaskan handel kredensial.

Nota

Header ntdsapi.h mendefinisikan DsMakePasswordCredentials sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE