queryActCtxSettingsW 函式 (winbase.h)

QueryActCtxSettingsW函式會指定啟用內容，以及要查詢之屬性的命名空間和名稱。

語法

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
);

參數

[in, optional] dwFlags

此值必須是 0。

[in, optional] hActCtx

正在查詢之啟用內容的控制碼。

[in, optional] settingsNameSpace

字串的指標，其中包含值 「 http://schemas.microsoft.com/SMI/2005/WindowsSettings" ; 或 Null。 這些值相等。

Windows 8 和 Windows Server 2012： 字串的指標，其中包含值 「 http://schemas.microsoft.com/SMI/2011/WindowsSettings" ; 也是有效的參數。 Null仍然相當於先前的值。

[in] settingName

要查詢的屬性名稱。

[out] pvBuffer

接收查詢結果之緩衝區的指標。

[in] dwBuffer

緩衝區的大小，以接收查詢結果的字元為單位。

[out, optional] pdwWrittenOrRequired

值的指標，這是寫入 pvBuffer 所指定之緩衝區的字元數，或是保存查詢結果所需的字元數。

傳回值

如果函式成功，則會傳回 TRUE。 否則會傳回 FALSE。

此函式會設定可藉由呼叫 GetLastError擷取的錯誤。 如需範例，請參閱 擷取 Last-Error 程式碼。 如需錯誤碼的完整清單，請參閱 系統錯誤碼。

規格需求