cwbUP_SetCallbackDLL

Purpose

Sets the fully qualified name of the callback DLL for an update entry.

Syntax

 
unsigned int CWB_ENTRY  cwbUP_SetCallbackDLL(
                              cwbUP_EntryHandle entryHandle,
                              char *dllPath);

Parameters

cwbUP_EntryHandle entryHandle - input

Handle that was returned by a previous call to cwbUP_CreateUpdateEntryHandle, cwbUP_GetUpdateEntryHandle, or cwbUP_FindEntry.

char * dllPath - input

Pointer to a null-terminated string that contains the fully qualified name of the DLL that will be called when individual stages of the update occur.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_HANDLE

Update entry handle is not valid.

CWB_INVALID_POINTER

NULL passed as an address parameter.

CWBUP_STRING_TOO_LONG

The callback DLL string is longer than the maximum of CWBUP_MAX_LENGTH.

CWBUP_ENTRY_IS_LOCKED

Another application is currently changing the update entry list. No changes are allowed at this time.

Usage

None