DdqGetDiagnosticRecordProducerCategories function (diagnosticdataquery.h)

Producers and categories have a hierarchical relationship--that is, categories belong to producers. This function fetches the available Category IDs and text representation of categories for a given diagnostic Producer Name.

Syntax

HRESULT DdqGetDiagnosticRecordProducerCategories(
  HDIAGNOSTIC_DATA_QUERY_SESSION         hSession,
  PCWSTR                                 producerName,
  HDIAGNOSTIC_EVENT_CATEGORY_DESCRIPTION *hCategoryDescription
);

Parameters

hSession

Type: HANDLE Handle to the Diagnostic Data Query session.

producerName

Type: PCWSTR The name of the producer of interest.

hCategoryDescription

Type: HANDLE Handle to the resource that contains the list of categories and their descriptions that belong to the given producer.

Return value

Type: HRESULT Returns S_OK on successful completion.

Remarks

See DIAGNOSTIC_DATA_EVENT_CATEGORY_DESCRIPTION for documentation on how a category is defined.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004 (10.0; Build 19041)
Minimum supported server Windows Server, version 2004 (10.0; Build 19041)
Header diagnosticdataquery.h