Header Files » Incs » 68k » libraries » telephony
HsPhoneSecurity.h

00001 /******************************************************************************
00002  * Copyright (c) 2004 palmOne, Inc. or its subsidiaries.
00003  * All rights reserved.
00004  *****************************************************************************/
00005 /** @ingroup Telephony
00006  *
00007  */
00008  
00009  
00010 /**
00011  * @file    HsPhoneSecurity.h
00012  *
00013  * @brief  Header File for Phone Library API ---- SECURITY CATEGORY
00014  *
00015  * Notes:
00016  *  All implementations of the Handspring Phone Library support a common API. 
00017  *  This API is broken up into various categories for easier management.  This file
00018  *  defines the public portion of the Security category.  These API calls are used 
00019  *  to protect access to device and phone features.
00020  *          
00021  */
00022 
00023 
00024 #ifndef HS_PHONESECURITY_H
00025 #define HS_PHONESECURITY_H
00026 #include <PalmOS.h>
00027 #include <PalmTypes.h>
00028 #ifndef __CORE_COMPATIBILITY_H__
00029 #include <PalmCompatibility.h>
00030     /** workaround for differing header files in sdk-3.5 and sdk-internal */
00031     #ifndef __CORE_COMPATIBILITY_H__
00032     #define __CORE_COMPATIBILITY_H__
00033     #endif 
00034 #endif 
00035 #include <HsPhoneTraps.h>     /**< trap table definition for phone library calls */
00036 #include <HsPhoneErrors.h>    /**< error codes returned by phone library functions */
00037 #include <HsPhoneTypes.h>
00038 
00039 /**
00040  *  @brief 
00041  * 
00042  *  @param refNum:  IN:
00043  *  @param lock:    IN:
00044  *  @param autoLockCheckBoxState:   IN:
00045  *  @retval Err Error code.
00046  **/
00047 extern Err PhnLibGetPhoneLock (UInt16 refNum, Boolean * lock, Boolean * autoLockCheckBoxState)
00048   PHN_LIB_TRAP(PhnLibTrapGetPhoneLock);
00049 
00050 extern Err PhnLibSetPhoneLock (UInt16 refNum, Boolean enable, PhnLockMode lockMode, CharPtr password)
00051       PHN_LIB_TRAP (PhnLibTrapSetPhoneLock);  
00052 
00053 extern Err PhnLibSetOperatorLock(UInt16 refNum, UInt16 facilityType, Boolean enable, CharPtr password)
00054                 PHN_LIB_TRAP(PhnLibTrapSetOperatorLock);
00055 
00056 
00057 extern Err PhnLibGetRemainingPasswordTries(UInt16 refNum, Int16* pinTries, Int16* pin2Tries, Int16* pukTries, Int16* puk2Tries)
00058                 PHN_LIB_TRAP(PhnLibTrapGetRemainingPasswordTries);
00059                                 
00060 extern Err PhnLibCRSM(UInt16 refNum, UInt16 command, UInt32 fileId, 
00061       UInt16 p1, UInt16 p2, UInt16 p3, UInt8* data, UInt16 dataSize, 
00062     UInt16* sw1, UInt16* sw2, char ** response, UInt16* responseSize) 
00063   PHN_LIB_TRAP(PhnLibTrapCRSM);
00064                                 
00065 
00066 #endif
Top	Palm Developer Network © 2004-2008, Palm, Inc. All rights reserved. Generated on Fri Jun 13 10:06:53 2008 for Palm API Guide