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 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 os dados WNODE_XXX 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 de nomes de instância estática do driver para o evento. Esse membro só será válido se o bloco de eventos tiver sido registrado com nomes de instância estáticos 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.
Comentários
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 Implementando o WMI.
O membro ProviderId da estrutura WNODE_HEADER para uso em uma estrutura WNODE_EVENT_REFERENCE deve ser inicializado usando IoWMIDeviceObjectToProviderId.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | wmistr.h (inclua Wmistr.h) |