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
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
Definition at line 550 of file cryptplugwrapper.cpp.