In This Topic ▼

IltmmConvert::OpenLogFile

Summary

Initializes a text file for logging conversion operations data.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmConvert_OpenLogFile(pConvert, filename, flags)
C++	HRESULT OpenLogFile(filename, flags)

Parameters

IltmmConvert *pConvert

Pointer to an IltmmConvert interface.

BSTR filename

A character string that contains the name of the file in which to save the logging information.

long flags

Value that represents the desired logging options. For a list of possible values, refer to ltmmLogFile_Flag constants.

Returns

Value	Meaning
S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Use the IltmmConvert::OpenLogFile function to initialize a file to log data about conversion operations. Use the ltmmConvert::CloseLogFile function to stop logging data to the file and close the file.

If the passed file name to the filename parameter is NULL, then the function will return an error.

If the passed file name to the filename parameter currently exists, and the ltmmLogFile_Append flag has not been passed to flags parameter, then the existing file will be overwritten.