Edit

Share via

EvtGetChannelConfigProperty function (winevt.h)

  • Article

Gets the specified channel configuration property.

Syntax

BOOL EvtGetChannelConfigProperty(
  [in]  EVT_HANDLE                     ChannelConfig,
  [in]  EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          PropertyValueBufferSize,
  [in]  PEVT_VARIANT                   PropertyValueBuffer,
  [out] PDWORD                         PropertyValueBufferUsed
);

Parameters

[in] ChannelConfig

A handle to the channel's configuration properties that the EvtOpenChannelConfig function returns.

[in] PropertyId

The identifier of the channel property to retrieve. For a list of property identifiers, see the EVT_CHANNEL_CONFIG_PROPERTY_ID enumeration.

[in] Flags

Reserved. Must be zero.

[in] PropertyValueBufferSize

The size of the PropertyValueBuffer buffer, in bytes.

[in] PropertyValueBuffer

A caller-allocated buffer that will receive the configuration property. The buffer contains an EVT_VARIANT object. You can set this parameter to NULL to determine the required buffer size.

[out] PropertyValueBufferUsed

The size, in bytes, of the caller-allocated buffer that the function used or the required buffer size if the function fails with ERROR_INSUFFICIENT_BUFFER.

Return value

Return code/value Description
TRUE
 The function succeeded.
FALSE
 The function failed. To get the error code, call the GetLastError function.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header winevt.h
Library Wevtapi.lib
DLL Wevtapi.dll

See also

EvtOpenChannelConfig