Partager via


Fonction PowerSettingAccessCheckEx (powrprof.h)

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