Compartir a través de

Función QueryActCtxSettingsW (winbase.h)

  • Artículo

La función QueryActCtxSettingsW especifica el contexto de activación y el espacio de nombres y el nombre del atributo que se va a consultar.

Sintaxis

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

Parámetros

[in, optional] dwFlags

Este valor debe ser de 0.

[in, optional] hActCtx

Identificador del contexto de activación que se está consultando.

[in, optional] settingsNameSpace

Puntero a una cadena que contiene el valor "http://schemas.microsoft.com/SMI/2005/WindowsSettings" o NULL. Estos valores son equivalentes.

Windows 8 y Windows Server 2012: Puntero a una cadena que contiene el valor "http://schemas.microsoft.com/SMI/2011/WindowsSettings" también es un parámetro válido. Un valor NULL sigue siendo equivalente al valor anterior.

[in] settingName

Nombre del atributo que se va a consultar.

[out] pvBuffer

Puntero al búfer que recibe el resultado de la consulta.

[in] dwBuffer

Tamaño del búfer en caracteres que recibe el resultado de la consulta.

[out, optional] pdwWrittenOrRequired

Puntero a un valor que es el número de caracteres escritos en el búfer especificado por pvBuffer o que es necesario para contener el resultado de la consulta.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE. De lo contrario, devuelve FALSE.

Esta función establece errores que se pueden recuperar llamando a GetLastError. Para obtener un ejemplo, consulte Recuperación del código de Last-Error. Para obtener una lista completa de los códigos de error, consulte Códigos de error del sistema.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll