LlSetNotificationCallbackExt

Syntax:

FARPROC LlSetNotificationCallbackExt (HLLJOB hJob, INT nEvent, FARPROC lpfnNotify);

Task:

Definition of a procedure which will be called for notifications of the given event.

Parameter:

hJob: List & Label job handle

nEvent: Event-ID (LL_CMND_xxx or LL_NTFY_xxxx)

lpfnNotify: The address of a function (see below)

Return Value:

Address of the procedure if successful, NULL otherwise

Hints:

The "specialized" callback function has a higher priority than the "general" callback function or a message.

List & Label first of all searches for a specialized callback function for the event to be raised. If one is defined, it will be called. If not, List & Label checks whether a general callback handler has been installed with LlSetNotificationCallback(). If so, it will be called. If not, List & Label checks whether a message for the current event has been defined using LlSetNotificationMessage(). If so, the message will be sent. This function may not be used with the .NET component as this component already uses the API for its own functionality.

The callback function has the following definition:

LPARAM STDCALL MyCallback(UINT nFunction, LPARAM lParam)

and must be an exported function

The definition of the parameter nFunction and lParam can be found in chapter Callbacks and Notifications.

Example:

LPARAM STDCALL MyCallback(UINT nFunction, LPARAM lParam)

//....

HLLJOB hJob;

unsigned int wMsg;

hJob = LlJobOpen(0);

v = LlSetNotificationCallbackExt(hJob, LL_CMND_CHANGE_DCPROPERTIES_DOC, MyCB);

// ....

LlJobClose(hJob);