Bagikan melalui


Fungsi AllocADsStr (adshlp.h)

Fungsi AllocADsStr mengalokasikan memori untuk dan menyalin string tertentu.

Sintaks

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

Parameter

[in] pStr

Jenis: LPWSTR

Penunjuk ke string Unicode yang dihentikan null untuk disalin.

Menampilkan nilai

Jenis: LPWSTR

Ketika berhasil, fungsi mengembalikan penunjuk non-NULL ke memori yang dialokasikan. String dalam pStr disalin ke buffer ini dan dihentikan null. Pemanggil harus membebaskan memori ini ketika tidak lagi diperlukan dengan meneruskan penunjuk yang dikembalikan ke FreeADsStr.

Mengembalikan NULL jika tidak berhasil. Panggil ADsGetLastError untuk mendapatkan status kesalahan yang diperpanjang. Untuk informasi selengkapnya tentang nilai kode kesalahan, lihat Kode Kesalahan ADSI.

Keterangan

Untuk informasi selengkapnya dan contoh kode yang menunjukkan cara menggunakan fungsi AllocADsStr , lihat ReallocADsStr.

Persyaratan

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

Lihat juga

Fungsi ADSI

ADsGetLastError

FreeADsStr

ReallocADsStr