Sun Java System Calendar Server 6 2005Q4 Developer's Guide

Method: Translate

Purpose

Implement the translation from one content type to another.

Syntax

PRUint32 Translate (char* aInContentType,
                    char* aOutContentType,
                    char** aInBuffer,
                    char** aOutBuffer,
                    PRInt32 *aInSize,
                    PRInt32 *aOutsize,
                    PRInt32 *aReturncode)=0;

Parameters

The method has the following parameters:

aInContentType

The incoming content type. 

aOutContentType

The outgoing content type. 

aInBuffer

The input data buffer. 

aOutBuffer

The output data buffer. 

aInSize

The input buffer size. 

aOutSize

The output buffer size. 

aReturnCode

On return, contains a constant that determines whether the server should continue with the default authentication procedure. 

One of the following constants: 

NS_CONTINUE_DEFAULT_PROCESSING

NS_OVERRIDE_DEFAULT_PROCESSING

Returns

NS_OK on success, non-zero on failure.

Description

This method retrieves content of the specified input type from the specified buffer, translates the content from its original format to the output format, stores the translated content in the specified output buffer, and stores the size of the output buffer at the specified location.