Bagikan melalui


Str_GetPtr (Fungsi Str_GetPtr)

[Fungsi ini tersedia melalui Windows XP dengan Paket Layanan 2 (SP2) dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Menyalin string dari satu buffer ke buffer lainnya.

Sintaks

int WINAPI Str_GetPtr(
  _In_    LPCTSTR pszSource,
  _Inout_ LPCSTR  pszDest,
  _In_    int     cchDest
);

Parameter

pszSource [in]

Jenis: LPCTSTR

Penunjuk ke string sumber.

pszDest [in, out]

Jenis: LPCSTR

Penunjuk ke buffer tujuan. Nilai ini bisa NULL.

cchDest [in]

Jenis: int

Ukuran pszDest, dalam karakter.

Nilai kembali

Jenis: int

Jika pszDest adalah NULL atau cchDest adalah nol, mengembalikan ukuran buffer, dalam karakter, yang diperlukan untuk berisi salinan string yang dihentikan null yang diarahkan oleh pszSource.

Jika pszDest bukan NULL, mengembalikan jumlah karakter yang berhasil disalin, termasuk karakter null yang mengakhiri.

Jika pszDest tidak dapat menahan seluruh string yang ditunjukkan oleh pszSource, maka karakter (cchDest-1) disalin, string dihentikan null, dan cchDest dikembalikan.

Keterangan

Str_GetPtr tersedia sebagai versi ANSI (Str_GetPtrA) dan Unicode (Str_GetPtrW). Fungsi-fungsi ini tidak diekspor berdasarkan nama atau dideklarasikan dalam file header publik. Untuk menggunakannya, Anda harus menggunakan GetProcAddress dan meminta ordinal 233 (Str_GetPtrA) atau 235 (Str_GetPtrW) dari ComCtl32.dll untuk mendapatkan penunjuk fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2003 [hanya aplikasi desktop]
DLL
ComCtl32.dll
Nama Unicode dan ANSI
Str_GetPtrW (Unicode) dan Str_GetPtrA (ANSI)