Bagikan melalui

Fungsi DdeQueryStringA (ddeml.h)

  • Artikel

Menyalin teks yang terkait dengan handel string ke dalam buffer.

Sintaksis

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 fungsi ANSI, 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.

Komentar

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 psz NULL, fungsi DdeQueryString mendapatkan panjang, dalam byte, dari string yang terkait dengan handel string. Panjang tidak termasuk karakter null yang dihentikan.

Nota

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

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header ddeml.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll

Lihat juga

Konseptual

DdeCmpStringHandles

DdeCreateStringHandle

DdeFreeStringHandle

DdeInitialize

Pustaka Manajemen Pertukaran Data Dinamis

Referensi