Compartilhar via

Função QueryActCtxSettingsW (winbase.h)

  • Artigo

A função QueryActCtxSettingsW especifica o contexto de ativação e o namespace e o nome do atributo que deve ser consultado.

Sintaxe

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

O valor deve ser 0.

[in, optional] hActCtx

Um identificador para o contexto de ativação que está sendo consultado.

[in, optional] settingsNameSpace

Um ponteiro para uma cadeia de caracteres que contém o valor "http://schemas.microsoft.com/SMI/2005/WindowsSettings" ou NULL. Esses valores são equivalentes.

Windows 8 e Windows Server 2012: Um ponteiro para uma cadeia de caracteres que contém o valor "http://schemas.microsoft.com/SMI/2011/WindowsSettings" também é um parâmetro válido. Um NULL ainda é equivalente ao valor anterior.

[in] settingName

O nome do atributo a ser consultado.

[out] pvBuffer

Um ponteiro para o buffer que recebe o resultado da consulta.

[in] dwBuffer

O tamanho do buffer em caracteres que recebe o resultado da consulta.

[out, optional] pdwWrittenOrRequired

Um ponteiro para um valor que é o número de caracteres gravados no buffer especificado por pvBuffer ou que é necessário para manter o resultado da consulta.

Valor retornado

Se a função for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.

Essa função define erros que podem ser recuperados chamando GetLastError. Para obter um exemplo, consulte Recuperando o código de Last-Error. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll