WinCvtGetExportConverterList

The WinCvtGetExportConverterList function retrieves the list of converters that can convert from RTF to a native format.

WINCVT_STATUS
WinCvtGetExportConverterList(
  WINCVT_CVT_LIST* List,    // The resulting list of converters.
  LPCSTR szClass,           // The class to look for (optional.)
  LPCSTR szExtension        // The extension to look for (optional.)
);

Parameters

List
Pointer to a list object. Upon successful completion of this function, this will point to a list of export conversion classes the system supports that match the specified extension and class criteria. To enumerate this list, use the WinCvtGetFirstClass and WinCvtGetNextClass functions. To free this list, call WinCvtFreeConverterList.
szClass
Specifies the class to locate. If specified, the list should contain at most one element corresponding to the entry for that class. If NULL, all classes of converters will be returned.
szExtension
Specifies the extension to look for. If specified, only classes that support exporting to the specified extension will be returned. This parameter can also include a full filename whose extension should be used in the search. If NULL, converters will be returned regardless of the extensions they support.

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 WinCvtGetExportConverterList function retrieves the list of converters that can convert from RTF to a native format. This list can be filtered by class or extension. If both szClass and szExtension are NULL, all export converters supported by the system will be returned. To install a new converter so that it will be returned by this function, use the WinCvtInstallConverter function. To list converters that support importing (converting from a format to RTF), use the WinCvtGetImportConverterList function.

QuickInfo

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

See Also

WinCvtFreeConverterList, WinCvtGetFirstClass, WinCvtGetNextClass, WinCvtGetErrorString, WinCvtGetImportConverterList, WinCvtInstallConverter.