estructura WNODE_EVENT_REFERENCE (wmistr.h)
La estructura de WNODE_EVENT_REFERENCE contiene información que WMI puede usar para consultar un evento que supere el límite de tamaño de evento establecido en el Registro.
Sintaxis
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;
Miembros
WnodeHeader
Es una estructura WNODE_HEADER que contiene información común a todas las estructuras WNODE_XXX , como el tamaño del búfer, el identificador de proveedor, el GUID que representa un bloque de datos asociado a una solicitud y marcas que proporcionan información sobre los datos WNODE_XXX que se pasan o devuelven.
TargetGuid
Indica el GUID que representa el evento que se va a consultar.
TargetDataBlockSize
Indica el tamaño del evento.
DUMMYUNIONNAME
DUMMYUNIONNAME.TargetInstanceIndex
Indica el índice en la lista del controlador de nombres de instancia estáticos para el evento. Este miembro solo es válido si el bloque de eventos se registró con nombres de instancia estáticos y WNODE_FLAGS_STATIC_INSTANCE_NAMES se establece en WnodeHeader.Flags.
DUMMYUNIONNAME.TargetInstanceName
Indica el nombre de instancia dinámico del evento como una cadena Unicode contada. Este miembro solo es válido si WNODE_FLAGS_STATIC_INSTANCE_NAMES está claro en WnodeHeader.Flags y el bloque de eventos se registró con nombres de instancia dinámicos.
Comentarios
Si la cantidad de datos de un evento supera el tamaño máximo establecido en el Registro, un controlador puede generar un WNODE_EVENT_REFERENCE que especifique un WNODE_EVENT_ITEM que WMI puede consultar para obtener el evento. Para obtener más información sobre cómo definir y generar eventos WMI, vea Implementación de WMI.
El miembro ProviderId de la estructura WNODE_HEADER para su uso en una estructura de WNODE_EVENT_REFERENCE debe inicializarse mediante IoWMIDeviceObjectToProviderId.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wmistr.h (incluye Wmistr.h) |