Fonction PowerSettingAccessCheckEx (powrprof.h)

Article
03/04/2024

Interroge un remplacement de stratégie de groupe pour les paramètres d’alimentation spécifiés et spécifie l’accès demandé pour le paramètre.

Syntaxe

DWORD PowerSettingAccessCheckEx(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid,
  [in]           REGSAM              AccessType
);

Paramètres

[in] AccessFlags

Type d’accès aux case activée pour les remplacements de stratégie de groupe.

Valeur	Signification
ACCESS_AC_POWER_SETTING_INDEX 0 (0x0)	Recherchez les remplacements sur les paramètres d’alimentation secteur.
ACCESS_DC_POWER_SETTING_INDEX 1 (0x1)	Recherchez les remplacements sur les paramètres d’alimentation dc.
ACCESS_SCHEME 16 (0x10)	Vérifiez les restrictions sur des schémas d’alimentation spécifiques.
ACCESS_ACTIVE_SCHEME 19 (0x13)	Vérifiez les restrictions sur les schémas d’alimentation actifs.
ACCESS_CREATE_SCHEME 20 (0x14)	Vérifiez les restrictions relatives à la création ou à la restauration des schémas d’alimentation.

[in, optional] PowerGuid

Identificateur du paramètre d’alimentation.

[in] AccessType

Type d’accès de sécurité pour le paramètre. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
KEY_READ	Combine les valeurs STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS et KEY_NOTIFY.
KEY_WRITE	Combine les droits d’accès STANDARD_RIGHTS_WRITE, KEY_SET_VALUE et KEY_CREATE_SUB_KEY.

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é.

Code/valeur de retour	Description
ERROR_SUCCESS 0 (0x0)	Le paramètre d’alimentation spécifié n’est actuellement pas remplacé par une stratégie de groupe.
ERROR_ACCESS_DISABLED_BY_POLICY 1260 (0x4EC)	Ce programme est bloqué par la stratégie de groupe. Pour plus d’informations, contactez votre administrateur système.
ERROR_INSTALL_REMOTE_DISALLOWED 1640 (0x668)	Seuls les administrateurs peuvent accéder à distance aux paramètres d’alimentation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	powrprof.h
Bibliothèque	Powrprof.lib
DLL	Powrprof.dll

Partager via