Compartir a través de

Función PowerSettingAccessCheckEx (powrprof.h)

  • Artículo

Consultas para una invalidación de directiva de grupo para la configuración de energía especificada y especifica el acceso solicitado para la configuración.

Sintaxis

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

Parámetros

[in] AccessFlags

Tipo de acceso para comprobar si hay invalidaciones de directiva de grupo.

Valor Significado
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
 Compruebe si hay invalidaciones en la configuración de alimentación de CA.
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
 Compruebe si hay invalidaciones en la configuración de alimentación del controlador de dominio.
ACCESS_SCHEME
16 (0x10)
 Compruebe si hay restricciones en esquemas de energía específicos.
ACCESS_ACTIVE_SCHEME
19 (0x13)
 Compruebe si hay restricciones en los esquemas de energía activos.
ACCESS_CREATE_SCHEME
20 (0x14)
 Compruebe si hay restricciones en la creación o restauración de esquemas de energía.

[in, optional] PowerGuid

Identificador de la configuración de energía.

[in] AccessType

Tipo de acceso de seguridad para la configuración. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
KEY_READ
 Combina los valores de STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS y KEY_NOTIFY.
KEY_WRITE
 Combina los derechos de acceso de STANDARD_RIGHTS_WRITE, KEY_SET_VALUE y KEY_CREATE_SUB_KEY.

Valor devuelto

Devuelve ERROR_SUCCESS (cero) si la llamada se realizó correctamente y un valor distinto de cero si se produjo un error en la llamada.

Código o valor devuelto Descripción
ERROR_SUCCESS
0 (0x0)
 La configuración de energía especificada no se invalida actualmente mediante una directiva de grupo.
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
 Una directiva de grupo bloquea este programa. Para obtener más información, póngase en contacto con el administrador del sistema.
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
 Solo los administradores pueden acceder de forma remota a la configuración de energía.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado powrprof.h
Library Powrprof.lib
Archivo DLL Powrprof.dll