Поделиться через

Функция 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
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll