cwbUP_GetCallbackDLL

Purpose

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

Syntax

 
unsigned int CWB_ENTRY  cwbUP_GetCallbackDLL(
                              cwbUP_EntryHandle entryHandle,
                              char *dllPath,
                              unsigned long bufferLength,
                              unsigned long *actualLength);

Parameters

cwbUP_EntryHandle entryHandle - input

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

char * dllPath - input/output

Pointer to a buffer that will receive the fully qualified name of the DLL that will be called when individual stages of the update occur.

unsigned long bufferLength - input

Length of the dllPath buffer. Space should be included for the null termination character. If the buffer is not large enough to hold the entire DLL name, an error will be returned and the actualLength parameter will be set to the number of bytes the dllPath buffer needs to be.

unsigned long * actualLength - input/output

Pointer to a length variable that will be set to the size of the buffer needed to contain the fully qualified DLL name.

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.

CWB_BUFFER_OVERFLOW

Buffer is too small to hold return data.

Usage

None