Fungsi DdeQueryStringA (ddeml.h)

Artikel
02/29/2024

Menyalin teks yang terkait dengan handel string ke dalam buffer.

Sintaks

DWORD DdeQueryStringA(
  [in]            DWORD idInst,
  [in]            HSZ   hsz,
  [out, optional] LPSTR psz,
  [in]            DWORD cchMax,
  [in]            int   iCodePage
);

Parameter

[in] idInst

Jenis: DWORD

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

[in] hsz

Jenis: HSZ

Handel ke string untuk disalin. Handel ini harus dibuat oleh panggilan sebelumnya ke fungsi DdeCreateStringHandle .

[out, optional] psz

Jenis: LPTSTR

Penunjuk ke buffer yang menerima string. Untuk mendapatkan panjang string, parameter ini harus diatur ke NULL.

[in] cchMax

Jenis: DWORD

Panjangnya, dalam karakter, dari buffer yang ditujukkan oleh parameter psz . Untuk versi ANSI dari fungsi, ini adalah jumlah byte; untuk versi Unicode, ini adalah jumlah karakter. Jika string lebih panjang dari ( cchMax– 1), string akan dipotong. Jika parameter psz diatur ke NULL, parameter ini diabaikan.

[in] iCodePage

Jenis: int

Halaman kode yang digunakan untuk merender string. Nilai ini harus CP_WINANSI atau CP_WINUNICODE.

Mengembalikan nilai

Jenis: DWORD

Jika parameter psz menentukan penunjuk yang valid, nilai yang dikembalikan adalah panjangnya, dalam karakter, dari teks yang dikembalikan (tidak termasuk karakter null yang mengakhiri). Jika parameter psz menentukan penunjuk NULL , nilai yang dikembalikan adalah panjang teks yang terkait dengan parameter hsz (tidak termasuk karakter null yang mengakhiri). Jika terjadi kesalahan, nilai yang dikembalikan adalah 0L.

Keterangan

String yang dikembalikan dalam buffer selalu dihentikan null. Jika string lebih panjang dari ( cchMax– 1), hanya karakter pertama ( cchMax– 1) dari string yang disalin.

Jika parameter pszADALAH NULL, fungsi DdeQueryString mendapatkan panjang, dalam byte, dari string yang terkait dengan handel string. Panjangnya tidak termasuk karakter null yang mengakhiri.

Catatan

Header ddeml.h mendefinisikan DdeQueryString 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

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