Compartilhar via

estrutura REASON_CONTEXT (minwinbase.h)

  • Artigo

Contém informações sobre uma solicitação de energia. Essa estrutura é usada pelas funções PowerCreateRequest e SetWaitableTimerEx .

Sintaxe

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;

Membros

Version

O número de versão da estrutura. Esse parâmetro deve ser definido como POWER_REQUEST_CONTEXT_VERSION.

Flags

O formato do motivo da solicitação de energia. Esse parâmetro pode usar um dos valores a seguir:

Valor Significado
POWER_REQUEST_CONTEXT_DETAILED_STRING
0x00000002
 A estrutura Detalhada identifica um recurso de cadeia de caracteres localizável que descreve o motivo da solicitação de energia.
POWER_REQUEST_CONTEXT_SIMPLE_STRING
0x00000001
 O parâmetro SimpleReasonString contém uma cadeia de caracteres simples e não localizável que descreve o motivo da solicitação de energia.

Reason

Uma união que consiste em uma estrutura Detalhada ou uma cadeia de caracteres.

Reason.Detailed

Uma estrutura que identifica um recurso de cadeia de caracteres localizável para descrever o motivo da solicitação de energia.

Reason.Detailed.LocalizedReasonModule

O módulo que contém o recurso de cadeia de caracteres.

Reason.Detailed.LocalizedReasonId

A ID do recurso de cadeia de caracteres.

Reason.Detailed.ReasonStringCount

O número de cadeias de caracteres no parâmetro ReasonStrings .

Reason.Detailed.ReasonStrings

Uma matriz de cadeias de caracteres a serem substituídas no recurso de cadeia de caracteres em tempo de execução.

Reason.SimpleReasonString

Uma cadeia de caracteres não localizada que descreve o motivo da solicitação de energia.

Comentários

É seguro passar cadeias de caracteres somente leitura como SimpleReasonString ou ReasonStrings porque as funções PowerCreateRequest e SetWaitableTimerEx leem das cadeias de caracteres e não gravam nelas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho minwinbase.h (inclua Windows.h)

Confira também

PowerCreateRequest

SetWaitableTimerEx