WinCvtConvertToNative

The WinCvtConvertToNative function converts a stream of RTF into an arbitary, specified, format.

WINCVT_STATUS
WinCvtConvertToNative(
  LPCSTR szFileName, // The path of the file to create in native format.
  LPCSTR szConverter,// The path of the converter to use (optional.)
  LPCSTR szClass,    // The class of the conversion to use.
  HANDLE hInput,     // An open stream of RTF to convert from.
  _WinCvtProgressCallback ProgressRoutine // Routine for progress notifications (optional.)
);

Parameters

szFileName

The path of the file to create in native format.

szConverter

The path of the converter to use for the conversion. If NULL, the path of the converter is determined by reading the class from the registry. This can be obtained by calling the WinCvtGetClassFileName function.

szClass

The class of the conversion to use. This can be obtained by calling the WinCvtGetClassName function.

hInput

The input stream from which to read RTF. This can be an opened file.

ProgressRoutine

Specifies the routine to receive progress notifications. If NULL, no progress notifications will be issued. This may only be specified on WinCvt 0.3.1 or newer; on older builds, it must be NULL.

Return Values

If the function succeeds, the return value is WINCVT_SUCCESS. If the function fails, the return value is the error code describing the failure. This code can be turned into a human readable string using the WinCvtGetErrorString.

Remarks

The WinCvtConvertToNative function converts a stream of RTF into an arbitary, specified, format. For simplified conversion, use the WinCvtConvertFile function. To obtain RTF data prior to calling WinCvtConvertToNative, use the WinCvtConvertToRtf function.

QuickInfo

WinCvt: Requires 0.1.0.
Header: Declared in WinCvt.h.
Import Library: Use WinCvt.lib.

See Also

WinCvtConvertFile, WinCvtConvertToRtf, WinCvtGetClassFileName, WinCvtGetClassName, WinCvtGetErrorString, WinCvtProgressCallback.