/** @addtogroup TLC_CONTENT_MANAGER | |
* @{ | |
* @file | |
* Content Manager API. | |
* | |
* This header file describes the interface to the content management trustlet | |
* connector (Content Manager). | |
* | |
* <!-- Copyright Giesecke & Devrient GmbH 2009 - 2012 --> | |
* | |
* Redistribution and use in source and binary forms, with or without | |
* modification, are permitted provided that the following conditions | |
* are met: | |
* 1. Redistributions of source code must retain the above copyright | |
* notice, this list of conditions and the following disclaimer. | |
* 2. Redistributions in binary form must reproduce the above copyright | |
* notice, this list of conditions and the following disclaimer in the | |
* documentation and/or other materials provided with the distribution. | |
* 3. The name of the author may not be used to endorse or promote | |
* products derived from this software without specific prior | |
* written permission. | |
* | |
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS | |
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | |
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY | |
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE | |
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | |
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, | |
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING | |
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
*/ | |
#include "MobiCoreDriverApi.h" | |
#include "mcUuid.h" | |
#include "tlCmApi.h" | |
#include "tlCmError.h" | |
#ifdef __cplusplus | |
extern "C" { | |
#endif | |
/** Opens a content management session. | |
* | |
* After opening a content management session the content manager is ready to | |
* accecpt content management requests. Upon successful execution, this function | |
* sets the cmp pointer to a content management protocol object that is to be | |
* used for subsequent content management operations. | |
* | |
* @param [out] cmp Content management protocol object. | |
* | |
* @return MC_DRV_OK or error code. | |
*/ | |
mcResult_t cmOpen(cmp_t** cmp); | |
/** Closes a content management session. | |
* | |
* @return MC_DRV_OK or error code. | |
*/ | |
mcResult_t cmClose(void); | |
/** Performs a content management operation. | |
* | |
* Executes the command contained in the content management protocol object | |
* | |
* returned from cmOpen. The result of the content management operation is also | |
* conveyed within the CMP object returned from cmOpen, unless the overall | |
* operation was aborted due to a low-level driver error, in which case the | |
* return value of this routine is different to MC_DRV_OK. | |
* | |
* @return Indication as to whether the content management operation was executed. | |
* MC_DRV_OK denotes that the operation was executed (see response contents of | |
* the cmp_t object for details about the result of the operation). | |
*/ | |
mcResult_t cmManage(void); | |
#ifdef __cplusplus | |
} | |
#endif | |
/** @} */ | |