---

medium.h

Go to the documentation of this file.

/***************************************************************************
 $RCSfile: medium.h,v $
                             -------------------
    cvs         : $Id: medium.h,v 1.30 2003/06/07 20:22:20 aquamaniac Exp $
    begin       : Sun Nov 18 2001
    copyright   : (C) 2001 by Martin Preuss
    email       : openhbci@aquamaniac.de


 ***************************************************************************
 *                                                                         *
 *   This library is free software; you can redistribute it and/or         *
 *   modify it under the terms of the GNU Lesser General Public            *
 *   License as published by the Free Software Foundation; either          *
 *   version 2.1 of the License, or (at your option) any later version.    *
 *                                                                         *
 *   This library is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU     *
 *   Lesser General Public License for more details.                       *
 *                                                                         *
 *   You should have received a copy of the GNU Lesser General Public      *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef HBCIMEDIUM_H
#define HBCIMEDIUM_H

#ifdef __cplusplus
#include <string>
#endif

#include <openhbci/dllimport.h>
#include <openhbci/pointer.h>
#include <openhbci/error.h>

#ifdef __cplusplus
namespace HBCI {
    class Medium;
};
typedef struct HBCI::Medium HBCI_Medium;
#else /* __cplusplus */
typedef struct HBCI_Medium HBCI_Medium;
#endif /* __cplusplus */

typedef enum MediumType {
  MediumTypeUnknown=0,
  MediumTypeCard,

  MediumTypeFile
} MediumType;


#include <openhbci/user.h>
#include <openhbci/hbci.h>


#ifdef __cplusplus
namespace HBCI {
class DLLIMPORT Medium {
protected:
  const Hbci *_hbci;
  int _version;
  Pointer<User> _owner;

  string ripe(const string &source);

public:
  Medium(const Hbci *hbci);

  virtual ~Medium();

  const Hbci *hbci() const { return _hbci;};

  void setOwner(Pointer<User> u) { _owner=u;};
  Pointer<User> owner() { return _owner;};

  virtual Error selectContext(int country,
                              const string &instcode,
                              const string &userid)=0;

  virtual Error mountMedium(const string &pin="")=0;

  virtual Error unmountMedium(const string &pin="")=0;

  virtual unsigned int nextSEQ()=0;

  virtual Error changePIN()=0;

  virtual Error changeContext(int context, int country=0,
                              const string instcode="",
                              const string userid="",
                              const string custid="",
                              const string server="")=0;

  virtual bool isMounted() =0;

  virtual string mediumId() const =0;

  virtual int securityMode() const =0;

  virtual const string& mediumName() const =0;

  virtual MediumType mediumType() const =0;

  virtual string mediumTypeName() const =0;

  virtual int signKeyNumber() const =0;

  virtual int signKeyVersion() const =0;

  virtual int cryptKeyNumber() const =0;

  virtual int cryptKeyVersion() const =0;

  virtual Error getContext(int num,
                           int &countrycode,
                           string &instcode,
                           string &userid,
                           string &server) const =0;
  virtual string createMessageKey() const =0;

  virtual string encryptKey(const string &srckey)=0;

  virtual string decryptKey(const string &srckey)=0;

  virtual Error verify(const string &data, const string &signature)=0;

  virtual string sign(const string &data)=0;

  virtual string encrypt(const string &src, const string &key);

  virtual string decrypt(const string &src, const string &key);
  virtual Error getProperty(const string &propertyName,
                            string &propertyValue);

  virtual Error setProperty(const string &propertyName,
                            const string &propertyValue);

};

} /* namespace HBCI */

extern "C" {
#endif /* __cplusplus */

  extern HBCI_Error * HBCI_Medium_selectContext(HBCI_Medium *h,
                                                int country,
                                                const char *instcode,
                                                const char *userid);
  extern HBCI_Error *
    HBCI_Medium_mountMedium(HBCI_Medium *h, const char *pin);

  extern HBCI_Error *
    HBCI_Medium_unmountMedium(HBCI_Medium *h, const char *pin);
  extern int HBCI_Medium_isMounted(HBCI_Medium *h);

  extern char *HBCI_Medium_mediumId(const HBCI_Medium *h);

  extern int HBCI_Medium_securityMode(const HBCI_Medium *h);

  extern const char *HBCI_Medium_mediumName(const HBCI_Medium *h);

  extern HBCI_Error * HBCI_Medium_getContext(const HBCI_Medium *h,
                                             int num,
                                             int *countrycode,
                                             char **instcode,
                                             char **userid,
                                             char **server);

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif

---