EVT_PUBLISHER_METADATA_PROPERTY_ID 枚举 (winevt.h)

定义标识提供程序的元数据属性的标识符。

语法

typedef enum _EVT_PUBLISHER_METADATA_PROPERTY_ID {
  EvtPublisherMetadataPublisherGuid = 0,
  EvtPublisherMetadataResourceFilePath,
  EvtPublisherMetadataParameterFilePath,
  EvtPublisherMetadataMessageFilePath,
  EvtPublisherMetadataHelpLink,
  EvtPublisherMetadataPublisherMessageID,
  EvtPublisherMetadataChannelReferences,
  EvtPublisherMetadataChannelReferencePath,
  EvtPublisherMetadataChannelReferenceIndex,
  EvtPublisherMetadataChannelReferenceID,
  EvtPublisherMetadataChannelReferenceFlags,
  EvtPublisherMetadataChannelReferenceMessageID,
  EvtPublisherMetadataLevels,
  EvtPublisherMetadataLevelName,
  EvtPublisherMetadataLevelValue,
  EvtPublisherMetadataLevelMessageID,
  EvtPublisherMetadataTasks,
  EvtPublisherMetadataTaskName,
  EvtPublisherMetadataTaskEventGuid,
  EvtPublisherMetadataTaskValue,
  EvtPublisherMetadataTaskMessageID,
  EvtPublisherMetadataOpcodes,
  EvtPublisherMetadataOpcodeName,
  EvtPublisherMetadataOpcodeValue,
  EvtPublisherMetadataOpcodeMessageID,
  EvtPublisherMetadataKeywords,
  EvtPublisherMetadataKeywordName,
  EvtPublisherMetadataKeywordValue,
  EvtPublisherMetadataKeywordMessageID,
  EvtPublisherMetadataPropertyIdEND
} EVT_PUBLISHER_METADATA_PROPERTY_ID;

常量

EvtPublisherMetadataPublisherGuid 值： 0 标识提供程序的 guid 属性。 此属性的变体类型为 EvtVarTypeGuid。
EvtPublisherMetadataResourceFilePath 标识提供程序的 resourceFilePath 属性。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataParameterFilePath 标识提供程序的 parameterFilePath 属性。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataMessageFilePath 标识提供程序的 messageFilePath 属性。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataHelpLink 标识提供程序的 helpLink 属性。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataPublisherMessageID 标识提供程序 的消息 属性。 元数据是分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 此属性的变体类型为 EvtVarTypeUInt32。 如果提供程序未指定消息，则值为 –1。
EvtPublisherMetadataChannelReferences 标识提供程序 的通道 子元素。 此属性的变体类型为 EvtVarTypeEvtHandle。 若要访问提供程序定义或导入的通道的元数据，请在调用 EvtGetObjectArrayProperty 函数时使用此句柄。 有关详细信息，请参阅“备注”。 完成句柄后，调用 EvtClose 函数。
EvtPublisherMetadataChannelReferencePath 标识通道的 name 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataChannelReferenceIndex 标识通道列表中通道的从零开始的索引值。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。
EvtPublisherMetadataChannelReferenceID 标识通道 的值 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。
EvtPublisherMetadataChannelReferenceFlags 标识指示此通道是否从另一个提供程序导入的标志值。 如果设置了 EvtChannelReferenceImported 标志值，则导入通道。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。
EvtPublisherMetadataChannelReferenceMessageID 标识通道 的消息 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 属性包含分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 如果通道未指定消息，则值为 –1。
EvtPublisherMetadataLevels 标识提供程序的 levels 子元素。 此属性的变体类型为 EvtVarTypeEvtHandle。 若要访问提供程序定义或引用的级别的元数据，请在调用 EvtGetObjectArrayProperty 函数时使用此句柄。 有关详细信息，请参阅“备注”。 完成句柄后，调用 EvtClose 函数。
EvtPublisherMetadataLevelName 标识级别的 name 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataLevelValue 标识级别的 值 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。
EvtPublisherMetadataLevelMessageID 标识级别的 消息 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 属性包含分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 如果级别未指定消息，则值为 –1。
EvtPublisherMetadataTasks 标识 提供程序的任务子 元素。 此属性的变体类型为 EvtVarTypeEvtHandle。 若要访问提供程序定义的任务的元数据，请在调用 EvtGetObjectArrayProperty 函数时使用此句柄。 有关详细信息，请参阅“备注”。 完成句柄后，调用 EvtClose 函数。
EvtPublisherMetadataTaskName 标识任务的 name 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataTaskEventGuid 标识任务的 eventGuid 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataTaskValue 标识任务 的值 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。
EvtPublisherMetadataTaskMessageID 标识任务 的消息 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 属性包含分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 如果任务未指定消息，则值为 –1。
EvtPublisherMetadataOpcodes 标识提供程序的 opcodes 子元素。 此属性的变体类型为 EvtVarTypeEvtHandle。 若要访问提供程序定义或引用的操作码的元数据，请在调用 EvtGetObjectArrayProperty 函数时使用此句柄。 有关详细信息，请参阅“备注”。 完成句柄后，调用 EvtClose 函数。
EvtPublisherMetadataOpcodeName 标识操作码的 name 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataOpcodeValue 标识操作码 的值 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 高字包含 opcode 值，低字包含其所属的任务。 如果低字为零，则全局定义 opcode;否则，操作代码是特定于任务的。 使用低字值确定定义操作码的任务。
EvtPublisherMetadataOpcodeMessageID 标识操作代码 的消息 属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 属性包含分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 如果操作代码未指定消息，则值为 –1。
EvtPublisherMetadataKeywords 标识提供程序的 关键字 子元素。 此属性的变体类型为 EvtVarTypeEvtHandle。 若要访问提供程序定义的关键字的元数据，请在调用 EvtGetObjectArrayProperty 函数时使用此句柄。 有关详细信息，请参阅“备注”。 完成句柄后，调用 EvtClose 函数。
EvtPublisherMetadataKeywordName 标识关键字 (keyword) 的名称属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeString。
EvtPublisherMetadataKeywordValue 标识关键字 (keyword) 的掩码属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt64。
EvtPublisherMetadataKeywordMessageID 标识关键字 (keyword) 的消息属性。 调用 EvtGetObjectArrayProperty 函数时使用此标识符。 有关详细信息，请参阅“备注”。 此属性的变体类型为 EvtVarTypeUInt32。 属性包含分配给消息字符串的资源标识符。 若要获取消息字符串，请调用 EvtFormatMessage 函数。 如果关键字 (keyword) 未指定消息，则值为 –1。
EvtPublisherMetadataPropertyIdEND 此枚举值标记枚举值的末尾。

注解

此枚举中的标识符列表适用于无法更改的属性。 若要获取通道的配置，请调用 EvtGetChannelConfigProperty 函数。

调用 EvtGetPublisherMetadataProperty 函数时，不能使用以下属性标识符：

• EvtPublisherMetadataChannelReferencePath
• EvtPublisherMetadataChannelReferenceIndex
• EvtPublisherMetadataChannelReferenceID
• EvtPublisherMetadataChannelReferenceFlags
• EvtPublisherMetadataChannelReferenceMessageID
• EvtPublisherMetadataLevelName
• EvtPublisherMetadataLevelValue
• EvtPublisherMetadataLevelMessageID
• EvtPublisherMetadataTaskName
• EvtPublisherMetadataTaskEventGuid
• EvtPublisherMetadataTaskValue
• EvtPublisherMetadataTaskMessageID
• EvtPublisherMetadataOpcodeName
• EvtPublisherMetadataOpcodeValue
• EvtPublisherMetadataOpcodeMessageID
• EvtPublisherMetadataKeywordName
• EvtPublisherMetadataKeywordValue
• EvtPublisherMetadataKeywordMessageID

若要使用这些标识符，必须先检索属性的父对象的句柄。 若要检索通道属性，必须先使用 EvtPublisherMetadataChannelReferences 标识符检索父对象的句柄;若要检索级别属性，必须先使用 EvtPublisherMetadataLevels 标识符检索父对象的句柄;若要检索任务属性，必须先使用 EvtPublisherMetadataTasks 标识符检索父对象的句柄;若要检索 opcode 属性，必须先使用 EvtPublisherMetadataOpcodes 标识符检索父对象的句柄;若要检索关键字 (keyword) 属性，必须先使用 EvtPublisherMetadataKeywords 标识符检索父对象的句柄。

句柄指向对象数组，这些对象包含提供程序定义的子类型的元数据。 若要确定数组中的对象数，请调用 EvtGetObjectArraySize 函数。 若要访问其中一个对象的属性，请调用 EvtGetObjectArrayProperty 函数并指定要检索的属性的标识符。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	winevt.h

另请参阅

ChannelType 复杂类型

EVT_EVENT_METADATA_PROPERTY_ID

EVT_VARIANT_TYPE

EvtGetPublisherMetadataProperty

ProviderType 复杂类型