estructura REASON_CONTEXT (minwinbase.h)

Contiene información sobre una solicitud de energía. Esta estructura se usa en las funciones PowerCreateRequest y SetWaitableTimerEx .

Sintaxis

typedef struct _REASON_CONTEXT {
  ULONG Version;
  DWORD Flags;
  union {
    struct {
      HMODULE LocalizedReasonModule;
      ULONG   LocalizedReasonId;
      ULONG   ReasonStringCount;
      LPWSTR  *ReasonStrings;
    } Detailed;
    LPWSTR SimpleReasonString;
  } Reason;
} REASON_CONTEXT, *PREASON_CONTEXT;

Miembros

Version

Número de versión de la estructura. Este parámetro debe establecerse en POWER_REQUEST_CONTEXT_VERSION.

Flags

Formato del motivo de la solicitud de energía. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
POWER_REQUEST_CONTEXT_DETAILED_STRING 0x00000002	La estructura Detallada identifica un recurso de cadena localizable que describe el motivo de la solicitud de energía.
POWER_REQUEST_CONTEXT_SIMPLE_STRING 0x00000001	El parámetro SimpleReasonString contiene una cadena simple y no localizable que describe el motivo de la solicitud de energía.

Reason

Unión que consta de una estructura Detallada o de una cadena.

Reason.Detailed

Estructura que identifica un recurso de cadena localizable para describir el motivo de la solicitud de energía.

Reason.Detailed.LocalizedReasonModule

Módulo que contiene el recurso de cadena.

Reason.Detailed.LocalizedReasonId

Identificador del recurso de cadena.

Reason.Detailed.ReasonStringCount

Número de cadenas en el parámetro ReasonStrings .

Reason.Detailed.ReasonStrings

Matriz de cadenas que se van a sustituir en el recurso de cadena en tiempo de ejecución.

Reason.SimpleReasonString

Cadena no localizada que describe el motivo de la solicitud de energía.

Comentarios

Es seguro pasar cadenas de solo lectura como SimpleReasonString o ReasonStrings porque las funciones PowerCreateRequest y SetWaitableTimerEx leen de las cadenas y no escriben en ellas.

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]
Encabezado	minwinbase.h (incluye Windows.h)

Consulte también

PowerCreateRequest

SetWaitableTimerEx