IltmmConvert::OpenLogFile

#include "ltmm.h"

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

IltmmConvert *pConvert;	/* pointer to an interface */
BSTR filename;	/* log file name */
long flags;	/* logging flags */

Initializes a text file for logging conversion operations data.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
filename	A character string that contains the name of the file in which to save the logging information.
flags	Value that represents the desired logging options. For a list of possible values, refer to ltmmLogFile_Flag Constants.

Returns

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.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Elements:	IltmmConvert::CloseLogFile
Topics:	Multimedia Function Group