EventSetInformation function (evntprov.h)

Configures an ETW event provider.

Syntax

ULONG EVNTAPI EventSetInformation(
  [in] REGHANDLE        RegHandle,
  [in] EVENT_INFO_CLASS InformationClass,
  [in] PVOID            EventInformation,
  [in] ULONG            InformationLength
);

Parameters

[in] RegHandle

Event provider registration handle. This is a handle returned by EventRegister.

[in] InformationClass

EVENT_INFO_CLASS value that specifies the configuration operation to be performed on the event provider.

[in] EventInformation

Pointer to a buffer that contains data to be used when configuring the event provider. The format of the data in this buffer depends on the value specified in the InformationClass parameter.

This value may be NULL if InformationLength is zero.

[in] InformationLength

The size (in bytes) of the data in the EventInformation buffer.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is one of the following error codes.

  • ERROR_INVALID_PARAMETER: The parameter is incorrect. For example, this error is returned if the RegHandle parameter is not a valid provider registration handle, if EventInformation is NULL but InformationLength is nonzero, or if the specified InformationLength is not valid for the given InformationClass.
  • ERROR_NOT_SUPPORTED: The request is not supported. This error is returned if the InformationClass parameter is not a recognized value.
  • Other: Use FormatMessage to obtain the message string for the returned error.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header evntprov.h
Library Advapi32.lib
DLL Advapi32.dll

See also

EVENT_INFO_CLASS

EventRegister