Fonction PowerEnumerate (powrprof.h)
Énumère les éléments spécifiés dans un schéma d’alimentation. Cette fonction est normalement appelée dans une boucle incrémentant le paramètre Index pour récupérer les sous-clés jusqu’à ce qu’elles soient toutes énumérées.
Syntaxe
DWORD PowerEnumerate(
[in, optional] HKEY RootPowerKey,
[in, optional] const GUID *SchemeGuid,
[in, optional] const GUID *SubGroupOfPowerSettingsGuid,
[in] POWER_DATA_ACCESSOR AccessFlags,
[in] ULONG Index,
[out, optional] UCHAR *Buffer,
[in, out] DWORD *BufferSize
);
Paramètres
[in, optional] RootPowerKey
Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.
[in, optional] SchemeGuid
Identificateur du schéma d’alimentation. Si ce paramètre a la valeur NULL, une énumération des stratégies d’alimentation est retournée.
[in, optional] SubGroupOfPowerSettingsGuid
Sous-groupe des paramètres d’alimentation. Si ce paramètre a la valeur NULL, une énumération des paramètres sous la clé PolicyGuid est retournée.
[in] AccessFlags
Ensemble d’indicateurs qui spécifie ce qui sera énuméré
[in] Index
Index de base zéro du schéma, du sous-groupe ou du paramètre énuméré.
[out, optional] Buffer
Pointeur vers une variable pour recevoir les éléments. Si ce paramètre a la valeur NULL, la fonction récupère la taille de la mémoire tampon requise.
[in, out] BufferSize
Pointeur vers une variable qui, à l’entrée, contient la taille de la mémoire tampon pointée par le paramètre Buffer . Si le paramètre Buffer a la valeur NULL ou si bufferSize n’est pas suffisamment grand, la fonction retourne ERROR_MORE_DATA et la variable reçoit la taille de mémoire tampon requise.
Valeur retournée
Retourne ERROR_SUCCESS (zéro) si l’appel a réussi, et une valeur différente de zéro si l’appel a échoué. Si la taille de mémoire tampon passée dans le paramètre BufferSize est trop petite, ou si le paramètre Buffer a la valeur NULL, ERROR_MORE_DATA est retourné et le DWORD pointé par le paramètre BufferSize est rempli avec la taille de mémoire tampon requise.
Configuration requise
Condition requise | Valeur |
---|---|
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 | powrprof.h |
Bibliothèque | PowrProf.lib |
DLL | PowrProf.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour