Compartilhar via


estrutura WNODE_EVENT_REFERENCE (wmistr.h)

A estrutura WNODE_EVENT_REFERENCE contém informações que o WMI pode usar para consultar um evento que excede o limite de tamanho do evento definido no registro.

Sintaxe

typedef struct tagWNODE_EVENT_REFERENCE {
  struct _WNODE_HEADER WnodeHeader;
  GUID                 TargetGuid;
  ULONG                TargetDataBlockSize;
  union {
    ULONG TargetInstanceIndex;
    WCHAR TargetInstanceName[];
  } DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;

Membros

WnodeHeader

É uma estrutura WNODE_HEADER que contém informações comuns a todas as estruturas de WNODE_XXX, como o tamanho do buffer, a ID do provedor, o GUID que representa um bloco de dados associado a uma solicitação e sinalizadores que fornecem informações sobre o WNODE_XXX dados que estão sendo passados ou retornados.

TargetGuid

Indica o GUID que representa o evento a ser consultado.

TargetDataBlockSize

Indica o tamanho do evento.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

Indica o índice na lista do driver de nomes de instância estática para o evento. Esse membro só será válido se o bloco de eventos tiver sido registrado com nomes de instância estática e WNODE_FLAGS_STATIC_INSTANCE_NAMES estiver definido em WnodeHeader.Flags.

DUMMYUNIONNAME.TargetInstanceName

Indica o nome da instância dinâmica do evento como uma cadeia de caracteres Unicode contada. Esse membro só será válido se WNODE_FLAGS_STATIC_INSTANCE_NAMES estiver claro em WnodeHeader.Flags e o bloco de eventos tiver sido registrado com nomes de instância dinâmica.

Observações

Se a quantidade de dados de um evento exceder o tamanho máximo definido no registro, um driver poderá gerar um WNODE_EVENT_REFERENCE que especifica um WNODE_EVENT_ITEM que o WMI pode consultar para obter o evento. Para obter mais informações sobre como definir e gerar eventos WMI, consulte ImplementandoWMI.

O ProviderId membro da estrutura WNODE_HEADER para uso em uma estrutura de WNODE_EVENT_REFERENCE deve ser inicializado usando IoWMIDeviceObjectToProviderId.

Requisitos

Requisito Valor
cabeçalho wmistr.h (inclua Wmistr.h)

Consulte também

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER