Condividi tramite


Funzione QueryActCtxSettingsW (winbase.h)

La funzione QueryActCtxSettingsW specifica il contesto di attivazione e lo spazio dei nomi e il nome dell'attributo su cui eseguire query.

Sintassi

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

Parametri

[in, optional] dwFlags

Questo valore deve essere 0.

[in, optional] hActCtx

Handle per il contesto di attivazione su cui viene eseguita una query.

[in, optional] settingsNameSpace

Puntatore a una stringa contenente il valore "http://schemas.microsoft.com/SMI/2005/WindowsSettings" o NULL. Questi valori sono equivalenti.

Windows 8 e Windows Server 2012: Puntatore a una stringa contenente il valore "http://schemas.microsoft.com/SMI/2011/WindowsSettings" è anche un parametro valido. Un valore NULL è ancora equivalente al valore precedente.

[in] settingName

Nome dell'attributo su cui eseguire una query.

[out] pvBuffer

Puntatore al buffer che riceve il risultato della query.

[in] dwBuffer

Dimensioni del buffer in caratteri che ricevono il risultato della query.

[out, optional] pdwWrittenOrRequired

Puntatore a un valore che corrisponde al numero di caratteri scritti nel buffer specificato da pvBuffer o che è necessario per contenere il risultato della query.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

Questa funzione imposta gli errori che possono essere recuperati chiamando GetLastError. Per un esempio, vedere Recupero del codice Last-Error. Per un elenco completo dei codici di errore, vedere Codici errore di sistema.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll