Fungsi DdeCreateStringHandleA (ddeml.h)

Artikel
03/04/2024

Membuat handel yang mengidentifikasi string yang ditentukan. Klien Dynamic Data Exchange (DDE) atau aplikasi server dapat meneruskan handel string sebagai parameter ke fungsi Dynamic Data Exchange Management Library (DDEML) lainnya.

Sintaks

HSZ DdeCreateStringHandleA(
  [in] DWORD  idInst,
  [in] LPCSTR psz,
  [in] int    iCodePage
);

Parameter

[in] idInst

Jenis: DWORD

Pengidentifikasi instans aplikasi yang diperoleh oleh panggilan sebelumnya ke fungsi DdeInitialize .

[in] psz

Jenis: LPTSTR

String null-terminated yang handelnya akan dibuat. String ini bisa hingga 255 karakter. Alasan untuk batas ini adalah bahwa fungsi manajemen string DDEML diimplementasikan menggunakan atom.

[in] iCodePage

Jenis: int

Halaman kode yang akan digunakan untuk merender string. Nilai ini harus CP_WINANSI (halaman kode default) atau CP_WINUNICODE, tergantung pada apakah versi ANSI atau Unicode dari DdeInitialize dipanggil oleh aplikasi klien.

Mengembalikan nilai

Jenis: HSZ

Jika fungsi berhasil, nilai yang dikembalikan adalah handel string.

Jika fungsi gagal, nilai yang dikembalikan adalah 0L.

Fungsi DdeGetLastError dapat digunakan untuk mendapatkan kode kesalahan, yang bisa menjadi salah satu nilai berikut:

Keterangan

Nilai handel string tidak terkait dengan kasus string yang diidentifikasinya.

Ketika aplikasi membuat handel string atau menerimanya dalam fungsi panggilan balik dan kemudian menggunakan fungsi DdeKeepStringHandle untuk menyimpannya, aplikasi harus membebaskan handel string tersebut ketika tidak lagi diperlukan.

Handel string khusus instans tidak dapat dipetakan dari handel string ke string dan kembali ke handel string. Ini ditunjukkan dalam contoh berikut, di mana fungsi DdeQueryString membuat string dari handel string dan DdeCreateStringHandle membuat handel string dari string tersebut, tetapi kedua handel tidak sama:

DWORD idInst; 
DWORD cb; 
HSZ hszInst, hszNew; 
PSZ pszInst; 
 
DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI); 
hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI); 
// hszNew != hszInst !

Catatan

Header ddeml.h mendefinisikan DdeCreateStringHandle 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 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ddeml.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll