IWTTLog::CreateLogDevice

The CreateLogDevice method creates a log device topology according to the device string.

HRESULT CreateLogDevice (
  VARIANT  vtDeviceStr,
  LONG*  phDevice
);

Parameters

vtDeviceStr

[in] A log device string, which has the following syntax.

$<device_type>:<parameter_list>($<child_device1>[; $<child_device2>; ...])

For more information about constructing a device string, see Device String.

phDevice

[out] A pointer to a handle that represents the device tracing topology.

Return Value

CreateLogDevice returns one of the following values:

  • S_OK
    The operation was successful.
  • S_FALSE
    The operation was successful but the last device has been detached, which has triggered a rollup.
  • HRESULT
    The operation failed. You should use the FAILED macro to check HRESULT values.

Requirements

IDL: Log.IDL

Library: WTTLogCM.dll

See Also

IWTTLog Interface (COM), IWTTLog::CloseLogDevice

Send feedback on this topic
Built on December 10, 2009