Fonction QueryActCtxSettingsW (winbase.h)

Article
08/27/2023

La fonction QueryActCtxSettingsW spécifie le contexte d’activation, ainsi que l’espace de noms et le nom de l’attribut à interroger.

Syntaxe

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

Paramètres

[in, optional] dwFlags

Cette valeur doit être 0.

[in, optional] hActCtx

Handle du contexte d’activation interrogé.

[in, optional] settingsNameSpace

Pointeur vers une chaîne qui contient la valeur «http://schemas.microsoft.com/SMI/2005/WindowsSettings" ; ou NULL. Ces valeurs sont équivalentes.

Windows 8 et Windows Server 2012 : Pointeur vers une chaîne qui contient la valeur «http://schemas.microsoft.com/SMI/2011/WindowsSettings" ; est également un paramètre valide. Une valeur NULL est toujours équivalente à la valeur précédente.

[in] settingName

Nom de l’attribut à interroger.

[out] pvBuffer

Pointeur vers la mémoire tampon qui reçoit le résultat de la requête.

[in] dwBuffer

Taille de la mémoire tampon en caractères qui reçoit le résultat de la requête.

[out, optional] pdwWrittenOrRequired

Pointeur vers une valeur qui correspond au nombre de caractères écrits dans la mémoire tampon spécifiée par pvBuffer ou qui est nécessaire pour contenir le résultat de la requête.

Valeur retournée

Si la fonction réussit, elle retourne TRUE. Sinon, il retourne FALSE.

Cette fonction définit les erreurs qui peuvent être récupérées en appelant GetLastError. Pour obtenir un exemple, consultez Récupération du code Last-Error. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll