Condividi tramite

Funzione PowerSettingAccessCheckEx (powrprof.h)

  • Articolo

Query per un override dei criteri di gruppo per le impostazioni di alimentazione specificate e specifica l'accesso richiesto per l'impostazione.

Sintassi

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

Parametri

[in] AccessFlags

Tipo di accesso da controllare per l'override dei criteri di gruppo.

Valore Significato
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
 Verificare la presenza di override nelle impostazioni di alimentazione AC.
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
 Verificare la presenza di override nelle impostazioni di alimentazione del controller di dominio.
ACCESS_SCHEME
16 (0x10)
 Verificare le restrizioni relative a schemi di alimentazione specifici.
ACCESS_ACTIVE_SCHEME
19 (0x13)
 Verificare le restrizioni per gli schemi di alimentazione attivi.
ACCESS_CREATE_SCHEME
20 (0x14)
 Verificare le restrizioni per la creazione o il ripristino di schemi di alimentazione.

[in, optional] PowerGuid

Identificatore dell'impostazione di alimentazione.

[in] AccessType

Tipo di accesso alla sicurezza per l'impostazione. Per altre informazioni, vedere Sicurezza delle chiavi del Registro di sistema e diritti di accesso.

Questo parametro può avere uno dei valori seguenti.

Valore Significato
KEY_READ
 Combina i valori STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS e KEY_NOTIFY.
KEY_WRITE
 Combina i diritti di accesso STANDARD_RIGHTS_WRITE, KEY_SET_VALUE e KEY_CREATE_SUB_KEY.

Valore restituito

Restituisce ERROR_SUCCESS (zero) se la chiamata ha esito positivo e un valore diverso da zero se la chiamata non è riuscita.

Codice/valore restituito Descrizione
ERROR_SUCCESS
0 (0x0)
 L'impostazione di alimentazione specificata non è attualmente sottoposta a override da un criterio di gruppo.
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
 Questo programma viene bloccato dai criteri di gruppo. Per ulteriori informazioni, contattare l'amministratore di sistema".
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
 Solo gli amministratori possono accedere in remoto alle impostazioni di alimentazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione powrprof.h
Libreria Powrprof.lib
DLL Powrprof.dll