struttura REASON_CONTEXT (minwinbase.h)

Articolo
03/05/2024

Contiene informazioni su una richiesta di alimentazione. Questa struttura viene usata dalle funzioni PowerCreateRequest e SetWaitableTimerEx .

Sintassi

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;

Members

Version

Numero di versione della struttura. Questo parametro deve essere impostato su POWER_REQUEST_CONTEXT_VERSION.

Flags

Formato del motivo della richiesta di alimentazione. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
POWER_REQUEST_CONTEXT_DETAILED_STRING 0x00000002	La struttura Dettagliata identifica una risorsa stringa localizzabile che descrive il motivo della richiesta di alimentazione.
POWER_REQUEST_CONTEXT_SIMPLE_STRING 0x00000001	Il parametro SimpleReasonString contiene una stringa semplice e non localizzabile che descrive il motivo della richiesta di alimentazione.

Reason

Unione costituita da una struttura Dettagliata o da una stringa.

Reason.Detailed

Struttura che identifica una risorsa stringa localizzabile per descrivere il motivo della richiesta di alimentazione.

Reason.Detailed.LocalizedReasonModule

Modulo che contiene la risorsa stringa.

Reason.Detailed.LocalizedReasonId

ID della risorsa stringa.

Reason.Detailed.ReasonStringCount

Numero di stringhe nel parametro ReasonStrings .

Reason.Detailed.ReasonStrings

Matrice di stringhe da sostituire nella risorsa stringa in fase di esecuzione.

Reason.SimpleReasonString

Stringa non localizzata che descrive il motivo della richiesta di alimentazione.

Commenti

È possibile passare stringhe di sola lettura come SimpleReasonString o ReasonStrings perché le funzioni PowerCreateRequest e SetWaitableTimerEx leggono dalle stringhe e non le scrivono.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	minwinbase.h (include Windows.h)

Vedi anche

PowerCreateRequest

SetWaitableTimerEx

Condividi tramite