certmanager/lib

Loading and Unloading the Plugin, General Functionality


Detailed Description

The functions in this section are used for loading and unloading plugins. Note that the actual locating of the plugin and the loading and unloading of the dynamic library is not covered here; this is MUA-specific code for which support code might already exist in the programming environments.


Enumerations

enum  CryptPlugWrapper::InitStatus {
  InitStatus_undef = 0, InitStatus_Ok = 1, InitStatus_NoLibName = 2, InitStatus_LoadError = 0x1000,
  InitStatus_InitError = 0x2000
}

Functions

bool CryptPlug::initialize (void)
bool CryptPlug::hasFeature (Feature)
void CryptPlugWrapper::deinitialize ()
InitStatus CryptPlugWrapper::initStatus (QString *errorMsg) const
bool CryptPlugWrapper::hasFeature (Feature)

Enumeration Type Documentation

enum CryptPlugWrapper::InitStatus [inherited]

Current initialization state.

This flag holding status of previous call of initialize function. If initialize was not called before return value will be CryptPlugInit_undef.

See also:
initStatus, initialize

Definition at line 467 of file cryptplugwrapper.h.


Function Documentation

void CryptPlugWrapper::deinitialize (  )  [inherited]

This function unloads the lib and frees all internal structures.

After this function has been called, no other plugin functions should be called; the behavior is undefined in this case.

Note:
Deinitializing sets the internal initStatus value back to InitStatus_undef.
See also:
initStatus, initialize, CryptPlugWrapper, ~CryptPlugWrapper

setActive, active

Definition at line 542 of file cryptplugwrapper.cpp.

bool CryptPlugWrapper::hasFeature ( Feature   )  [inherited]

This function returns true if the specified feature is available in the plugin, and false otherwise.

Not all plugins will support all features; a complete Sphinx implementation will support all features contained in the enum, however.

Note:
In case this function cannot be executed the system's error message may be retrieved by calling initStatus( QString* ).
Returns:
whether the relative feature is implemented or not

Definition at line 558 of file cryptplugwrapper.cpp.

bool CryptPlug::hasFeature ( Feature   )  [inherited]

This function frees all internal structures.This function returns true if the specified feature is available in the plugin, and false otherwise.

Not all plugins will support all features; a complete Sphinx implementation will support all features contained in the enum, however.

Note:
This function must be implemented by each plug-in using this API specification.

Definition at line 280 of file cryptplug.cpp.

bool CryptPlug::initialize ( void   )  [inherited]

This function sets up all internal structures.

Plugins that need no initialization should provide an empty implementation. The method returns true if the initialization was successful and false otherwise. Before this function is called, no other plugin functions should be called; the behavior is undefined in this case.

Note:
This function must be implemented by each plug-in using this API specification.

Definition at line 273 of file cryptplug.cpp.

CryptPlugWrapper::InitStatus CryptPlugWrapper::initStatus ( QString *  errorMsg  )  const [inherited]

Returns this CRYPTPLUG wrapper's initialization state.

Parameters:
errorMsg receives the last system error message, this value should be ignored if InitStatus value equals InitStatus_Ok.
Returns:
whether the relative library was loaded and initialized correctly
See also:
initialize, deinitialize, CryptPlugWrapper(), ~CryptPlugWrapper

setActive, active

Definition at line 550 of file cryptplugwrapper.cpp.

KDE Home | KDE Accessibility Home | Description of Access Keys