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 代码。 有关错误代码的完整列表，请参阅 系统错误代码。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll