p_contif.h

是一个手机功能的模拟程序

/*
 * Copyright (C) Ericsson Mobile Communications AB, 2000.
 * Licensed to AU-System AB.
 * All rights reserved.
 *
 * This software is covered by the license agreement between
 * the end user and AU-System AB, and may be used and copied
 * only in accordance with the terms of the said agreement.
 *
 * Neither Ericsson Mobile Communications AB nor AU-System AB
 * assumes any responsibility or liability for any errors or inaccuracies in
 * this software, or any consequential, incidental or indirect damage arising
 * out of the use of the Generic WAP Client software.
 */

/*========================================================================

	WAP Implementation Project

==========================================================================

	File: P_ContIF.h

	Description: PUSH Content Interface file.

	Author: Jens Pommer, AU-System Radio AB

	Revision history:
  	Date    Sign	Comment
  	991115	JPR		First version
	991116	JPR		Minor changes
	000207	JPR		Updated to support new WBXML-decoder
	000208	JPR		New functions added

=========================================================================*/

#ifndef _PUSHCONTENTIFH
#define _PUSHCONTENTIFH

#include "p_sidec.h"
#include "p_sldec.h"
#include "p_codec.h"

/*========================================================================

	Service Indication Functions

=========================================================================*/

/*========================================================================
	Si_BuildStructure
==========================================================================
Purpose:  Function to build the element structure needed to perform 
		  different operations. The returned value is the structure, or 
		  NULL if error. The pbData is left unchanged. It is the caller's 
		  responsibility to delete the structure after it is used. The 
		  parameters are as follows: 

		  pbData - pointer to the first byte in the indata.
		  pbEnd - pointer to the byte AFTER the last byte in the indata.
		  iCharset - integer containing the IANA-code of the charset.
		  iContentLevel - The level (WSP parameter) of the contenttype.
		  iViewID - The view for the user agent (used for error output)
======================================================================== */
pDECSTR Si_BuildStructure (BYTE *pbData, BYTE *pbEnd, INT16 iCharset, 
						   UINT8 iContentLevel, UINT8 iViewID);

/*========================================================================
	Si_DeleteStructure
==========================================================================
Purpose:  Function to delete a Si structure. The input (**) element 
		  must be of the type Si.
======================================================================== */
void Si_DeleteStructure (pDECSTR* ppDecStr);

/*========================================================================
	Si_GetSi
==========================================================================
Purpose:  Function to get the Si element of an Si structure. 
======================================================================== */
pELEMENTTYPE Si_GetSi (pDECSTR pDecStr);

/*========================================================================
	Si_GetIndication
==========================================================================
Purpose:  Function to get the Indication element of an Si structure. 
		  The input element must be of the type Si structure.
======================================================================== */
pELEMENTTYPE Si_GetIndication (pELEMENTTYPE pSi);

/*========================================================================
	Si_GetInfo
==========================================================================
Purpose:  Function to get the Info element of an Si structure. 
		  The input element must be of the type Si structure.
======================================================================== */
pELEMENTTYPE Si_GetInfo (pELEMENTTYPE pSi);

/*========================================================================
	Si_GetHref
==========================================================================
Purpose:  The function returns a copy of the href in the Si. 
		  NULL is returned if no href is present. The input element must 
		  be of the type Si Indication element. The string MUST be deleted
		  after it is used.
======================================================================== */
BYTE *Si_GetHref (pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetIndicationText
==========================================================================
Purpose:  The function returns a copy of the body text in the Si. 
		  NULL is returned if no text is present. The input element must 
		  be of the type Si Indication element. The string MUST be deleted
		  after it is used.
======================================================================== */
WCHAR *Si_GetIndicationText (pDECSTR pDecStr, pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetSiId
==========================================================================
Purpose:  The function returns a copy of the si-id in the Si. 
		  NULL is returned if no si-id is present. The input element must 
		  be of the type Si Indication element. The string MUST be deleted
		  after it is used.
======================================================================== */
WCHAR *Si_GetSiId (pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetCreated
==========================================================================
Purpose:  The function returns a copy of the Created date in the Si. 
		  0 is returned if no date is present. The input element must 
		  be of the type Si Indication element. 
======================================================================== */
UINT32 Si_GetCreated (pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetExpires
==========================================================================
Purpose:  The function returns a copy of the Expires date in the Si. 
		  0 is returned if no date is present. The input element must 
		  be of the type Si Indication element. 
======================================================================== */
UINT32 Si_GetExpires (pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetAction
==========================================================================
Purpose:  The function returns a copy of the Action data in the Si. The 
          return values are defined in PUSHDef.h
		  Default value (signal-medium) is returned if no data is present. 
		  The input element must be of the type Si Indication element. 
======================================================================== */
UINT8 Si_GetAction (pELEMENTTYPE pIndication);

/*========================================================================
	Si_GetNextItem
==========================================================================
Purpose:  The function returns the item in the Si. 
		  NULL is returned if no item or no more items is/are present. The 
		  input element must be of the type Si Info element. If pItem
		  is NULL, the first item element is retrieved. 
======================================================================== */
pELEMENTTYPE Si_GetNextItem (pELEMENTTYPE pInfo, pELEMENTTYPE pItem);

/*========================================================================