Destructor - deleting the CImportFile instance before calling WriteComplete() aborts the import operation

Cancel an outstanding asynchronous request to WriteData() or WriteDataComplete().

Retrieve the content MIME type based on available data

		while(!endofsource) 
			{
			source.read(data); 
			err = import->WriteData(data); 

			// When application supplies file handles it must always check to see if 
			// the agent needs a new file handle 
			while(err == KErrCANewFileHandleRequired) 
				{               
				//We need to find out the content MIME type based on available data
				TBuf<KMaxDataTypeLength> contentMime;
				if(import->ContentMimeTypeL(contentMime) == KErrNone)
					{
					//content MIME type is discovered. Now client code could do something
					//to determine the output location and supply the appropriate file handle
					
					
					}
				else
					{
					//content MIME type can't be determined yet. Client should decide the location for
					//output file now,e.g. a default location

					}
				        
				err = import->ContinueWithNewOutputFile(outputFileHandle, outputFileName); 
				// It is possible that the agent needs yet another file handle 
				outputFileHandle.Close(); // agent makes a copy so we don't need to keep our file handle 
				}
			}

Continue the last write operation with a new file handle as requested by the agent

Continue the last write operation with a new file handle and return the result asynchronously. NB: It is important that the handle passed to aFile and the descriptor passed to aFileName remain in scope until the request has completed.

Retrieve the import status

Used to indicate non fatal problems encountered during the import operation. Provides feedback to the client in case any problems are encountered.

The client can then decide whether or not to continue the import.

Get the agents suggestion for the file extension of the output file required by the agent

This function should only be called when the agent has returned KErrCANewFileHandleRequired from WriteData() or WriteDataComplete().

The extension must include the dot '.' character.

Get the agents suggestion for the file name (with extension) of the output file required by the agent

This function should only be called when the agent has returned KErrCANewFileHandleRequired from WriteData() or WriteDataComplete().

The file name is of the form filename.extension.

Gets the number of output files produced so far.

Return information about an output file generated by the import operation.

It is possible that the output file does not have the same name as the one suggested at the beginning of the import. An agent may need to use a particular file extension or a particular name.

The agent may decide not to store the output file in the output directory suggested at the start of the import. eg. it may store the file in its private server directory.

The output files may only appear in this array after the WriteDataComplete() function has been called.

Write a block of data from a file to an agent.

Asynchronously write a block of data from a file to an agent. Notifies the client when the write operation is complete. NB: It is important that the descriptor passed to aData remains in scope until the request has completed.

Signals to the agent that the entire file has now been transferred to the agent.

Signals to the agent that the entire file has now been transferred to the agent

Notifies the client when any final processing operation is complete.