dlm_ServerInitialize()

Initializes the DLM tap server.

#include "dlmsrv.h"

DlmResult dlm_ServerInitialize
    (
        DlmPassword        password,
        DlmServerCallback  callback
    );

dlm_ServerInitialize() initializes the DLM tap server. The password parameter is required. For details about password requirements, see DLM Security. The callback may be NULL. The prototype of the callback supplied is defined in dlmsrv.h. For details about the DLM callback mechanism, see DLM Callbacks.

If successful, dlm_ServerInitialize() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dlm_ERROR_FAILURE_INITIALIZING
• dlm_ERROR_INVALID_PASSWORD

dlm_ServerIsInitialized()
dlm_ServerUninitialize()

if ((result = dlm_ServerInitialize(password, callback)) < 0)
{
    printf("Error: failure initializing - %s.\n", dlm_ErrorMessage(result));
}
else
{
    /* do something */

    dlm_SrvUninitialize();
}