Up: GEOS SDK TechDocs | Up | Prev: IACPProcessMessage() ... | Next: InitFileEnumStringSection() ...

ImpexExportToMetafile()

TransError 	ImpexExportToMetafile(
        Handle		xlatLib,
        VMFileHandle		xferFile,
        FileHandle		metafile,
        dword		xferFormat,
        word		arg1,
        word		arg2,
        MemHandle *		errString);

This routine is used by translation libraries. The routine calls an intermediate translation library to finish translating a given file into the GEOS Metafile format.

Include: impex.goh

Warnings: If the routine does not fail with condition TE_CUSTOM, *errString may contain a random value. Do not use *errString if the routine did not return TE_CUSTOM.

ImpexImportExportCompleted()

void 	ImpexImportExportCompleted(
        ImpexTranslationParams *			itParams);

The application should send this message when it is finished importing or exporting data. The routine will send an appropriate acknowledgment message to the ImportControl or ExportControl object, depending on the settings of ITP_impexOD and ITP _returnMsg .

If the application has just finished an import, it should not have changed the ImpexTranslationParams structure. If it had just finished preparing data for export, it should have set the ITP _transferVMChain field to contain the handle of the head of the VM chain.

Warnings: This routine, in essence, informs the ImportControl or ExportControl object that the application is finished with the transfer file. The ImportControl will respond by destroying the transfer file; the ExportControl will call the appropriate translation library to produce an output file. Therefore, an application should not call this routine until it is absolutely finished with the transfer file.

ImpexImportFromMetafile()

TransError 	ImpexExportToMetafile(
        Handle		xlatLib,
        VMFileHandle		xferFile,
        FileHandle		metafile,
        dword *		xferFormat,
        word		arg1,
        word		arg2,
        MemHandle *		errString);

This routine is used by translation libraries. The routine calls an intermediate translation library to translate a given file from the GEOS Metafile format to an intermediate format.

Include: impex.goh

Warnings: If the routine does not fail with condition TE_CUSTOM, *errString may contain a random value. Do not use *errString if the routine did not return TE_CUSTOM.

InitFileCommit()

void	InitFileCommit(void);

This routine commits any changes to the GEOS.INI file, removing and replacing its stored backup. It ensures that no other threads are working on the file during the commit operation.

Include: initfile.h

InitFileDeleteCategory()

void	InitFileDeleteCategory(
        const char *category);

This routine deletes the specified category, along with all its entries, from the GEOS.INI file. Pass it the following:

category
A pointer to the null-terminated string representing the category to be deleted. This string ignores white space and is case-insensitive.

Include: initfile.h

InitFileDeleteEntry()

void	InitFileDeleteEntry(
        const char *category,
        const char *key);

This routine deletes an entry in the GEOS.INI file. Pass it the following:

category
A pointer to the null-terminated string representing the category in which the entry resides. This string ignores white space and is case-insensitive.
key
A pointer to the null-terminated string representing the key to be deleted.

Include: initfile.h

InitFileDeleteStringSection()

void	InitFileDeleteStringSection(
        const char *		category,
        const char *		key,
        word		stringNum);

This routine deletes the specified string section from the given blob in the GEOS.INI file. Pass it the following:

category
A pointer to the null-terminated string representing the category in which the entry resides. This string ignores white space and is case-insensitive.
key
A pointer to the null-terminated string representing the key to be edited.
stringNum
The zero-based string section number.

Include: initfile.h


Up: GEOS SDK TechDocs | Up | Prev: IACPProcessMessage() ... | Next: InitFileEnumStringSection() ...