MD_Initialize

Initializes the message dispatch library. Until this function is called, all other functions will return error code MDR_NOT_INITIALIZED.

The MD_Initialize function is not re-enterant. Do not call this function twice at the same time from two different threads.

The message dispatch library is designed to operate on a stable HSM system (either local or remote to the Host computer). During the initialization of the message dispatch library, the number of accessible HSMs is determined and HSM indices are allocated to accessible HSMs. These variables are utilized in other functions; therefore, if the HSM system should change the message dispatch library should be re-initialized.

Synopsis

  #include <md.h>
  MD_RV MD_Initialize(void)

Input Requirements

None

Input Parameters

None

Output Requirements

The function returns the following codes:

Function Code	Qualification
MDR_OK	No error
MDR_UNSUCCESSFUL	Error in operation. Operation failed.