Fungsi GetStateTextW (oleacc.h)

Mengambil string yang dilokalkan yang menjelaskan status objek untuk satu bendera bit status yang telah ditentukan sebelumnya. Karena nilai status adalah kombinasi dari satu atau beberapa bendera bit, klien memanggil fungsi ini lebih dari sekali untuk mengambil semua string status.

Sintaksis

UINT GetStateTextW(
  [in]  DWORD  lStateBit,
  [out] LPWSTR lpszState,
  [in]  UINT   cchState
);

Parameter

[in] lStateBit

Jenis: DWORD

Salah satu konstanta status objek .

[out] lpszState

Jenis: LPTSTR

Alamat buffer yang menerima string teks status. Jika parameter ini NULL, fungsi mengembalikan panjang string status, tidak termasuk karakter null.

[in] cchState

Jenis: UINT

Ukuran buffer yang diarahkan oleh parameter lpszStateBit . Untuk string ANSI, nilai ini diukur dalam byte; untuk string Unicode, string diukur dalam karakter.

Mengembalikan nilai

Jenis: UINT

Jika berhasil, dan jika lpszStateBit non-NULL, nilai yang dikembalikan adalah jumlah byte (string ANSI) atau karakter (string Unicode) yang disalin ke dalam buffer, tidak termasuk karakter yang dihentikan null. Jika lpszStateBitNULL, nilai yang dikembalikan mewakili panjang string, tidak termasuk karakter null.

Jika sumber daya string tidak ada, atau jika parameter lpszStateBit bukan penunjuk yang valid, nilai pengembaliannya adalah nol (0). Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi ini hanya menerima satu bit status pada satu waktu, bukan bitmask.

Persyaratan