Fungsi QueryActCtxSettingsW (winbase.h)

Fungsi QueryActCtxSettingsW menentukan konteks aktivasi, dan namespace serta nama atribut yang akan dikueri.

Sintaks

BOOL QueryActCtxSettingsW(
  [in, optional]  DWORD  dwFlags,
  [in, optional]  HANDLE hActCtx,
  [in, optional]  PCWSTR settingsNameSpace,
  [in]            PCWSTR settingName,
  [out]           PWSTR  pvBuffer,
  [in]            SIZE_T dwBuffer,
  [out, optional] SIZE_T *pdwWrittenOrRequired
);

Parameter

[in, optional] dwFlags

Nilai ini harus 0.

[in, optional] hActCtx

Handel ke konteks aktivasi yang sedang dikueri.

[in, optional] settingsNameSpace

Penunjuk ke string yang berisi nilai "http://schemas.microsoft.com/SMI/2005/WindowsSettings" atau NULL. Nilai-nilai ini setara.

Windows 8 dan Windows Server 2012: Penunjuk ke string yang berisi nilai "http://schemas.microsoft.com/SMI/2011/WindowsSettings" juga merupakan parameter yang valid. NULL masih setara dengan nilai sebelumnya.

[in] settingName

Nama atribut yang akan dikueri.

[out] pvBuffer

Penunjuk ke buffer yang menerima hasil kueri.

[in] dwBuffer

Ukuran buffer dalam karakter yang menerima hasil kueri.

[out, optional] pdwWrittenOrRequired

Penunjuk ke nilai yang merupakan jumlah karakter yang ditulis ke buffer yang ditentukan oleh pvBuffer atau yang diperlukan untuk menyimpan hasil kueri.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE. Jika tidak, ia mengembalikan FALSE.

Fungsi ini menetapkan kesalahan yang dapat diambil dengan memanggil GetLastError. Misalnya, lihat Mengambil Kode Last-Error. Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Sistem.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll