WinCvtInstallConverter

The WinCvtInstallConverter function registers a converter (a .cvt file) into the registry suitable for applications to use.

WINCVT_STATUS
WinCvtInstallConverter(
  LPCSTR szConverter, // The path of the converter to install
  BOOL bUserOnly      // If TRUE, install for this user only
);

Parameters

szConverter
The path of the converter to install into the registry. This path is entered into the registry along with converter information; be sure that the converter is in its final location before calling this function.
bUserOnly
If this value is TRUE, the converter is installed in the user registry. WinCvt applications will query this location along with the system registry, but other applications may not. If this value is FALSE, the converter is installed in the system-wide registry. This parameter is only supported on WinCvt 0.3.0 and newer; on earlier versions, it must be FALSE.

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 WinCvtInstallConverter function registers a converter (a .cvt file) into the registry suitable for applications to use. Once registered, it will be retrieved by the WinCvtGetExportConverterList and/or WinCvtGetImportConverterList functions. To uninstall the converter, call the WinCvtUninstallConverter function.

QuickInfo

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

See Also

WinCvtGetErrorString, WinCvtGetExportConverterList, WinCvtGetImportConverterList, WinCvtUninstallConverter.