DPA_EnumCallback

This function enumerates the items in a DPA.

Declaration

VOID 
DPA_EnumCallback (
    HDPA pdpa,
    PFNDPAENUMCALLBACK pfnCB,
    PVOID pData); 

The callback function has the prototype

typedef int (*PFNDPAENUMCALLBACK) (PVOID p, PVOID pData);

Parameters

The pdpa argument provides a handle to the DPA, or is NULL.

The pfnCB argument provides the address of the callback function.

The pData argument provides a caller-specific context to be passed on each invocation of the callback function.

Behaviour

If the pdpa and pfnCB arguments are not NULL, the function works upwards through the pointer array, from the start, calling the enumeration function once per pointer. Enumeration stops if the callback function returns zero.

Variations

Versions before 6.10 simply assume that pfnCB is not NULL.

Availability

The DPA_EnumCallback function is exported from COMCTL32.DLL as ordinal 385 in version 4.71 and higher. The implementation for version 6.10 and higher is built into a statically linked library and thence is also exported from the Internet Explorer module IERTUTIL.DLL as ordinal 80 in version 7.0 and higher.

This function was documented among the Settlement Program Interfaces in December 2002, but with Windows 2000 cited as the minimum operating system, despite many years of earlier availability.