DIGEST_FUNCTION callback function (imagehlp.h)

An application-defined callback function used by the ImageGetDigestStream function to process data.

The DIGEST_FUNCTION type defines a pointer to this callback function. DigestFunction is a placeholder for the application-defined function name.

Syntax

DIGEST_FUNCTION DigestFunction;

BOOL DigestFunction(
  [in] DIGEST_HANDLE refdata,
  [in] PBYTE pData,
  [in] DWORD dwLength
)
{...}

Parameters

[in] refdata

A user-supplied handle to the digest. This value is passed as a parameter to the ImageGetDigestStream function.

[in] pData

The data stream.

[in] dwLength

The size of the data stream, in bytes.

Return value

If the function succeeds, the return value should be TRUE. If the function fails, the return value should be FALSE.

Remarks

All ImageHlp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imagehlp.h

See also

ImageGetDigestStream

ImageHlp Functions