SymbolServerCallback Callback Function

An entry point to the symbol server DLL.

The PSYMBOLSERVERCALLBACKPROC type defines a pointer to this callback function. SymbolServerCallback is a placeholder for the library-defined function name.

BOOL CALLBACK SymbolServerCallback(
                       UINT_PTR action,
                       ULONG64 data,
                       ULONG64 context
);

Parameters

action

The action code. This parameter can be one of the following values.

Value	Meaning
SSRVACTION_EVENT 3	Provide debug trace information. The data parameter is a pointer to an IMAGEHLP_CBA_EVENT structure. DbgHelp 6.0 and earlier:  This value is not supported.
SSRVACTION_QUERYCANCEL 2	Cancel the file copy. The data parameter is a ULONG64 value. If this value is zero, continue the operation. Otherwise, cancel the operation. DbgHelp 6.0 and earlier:  This value is not supported.
SSRVACTION_SIZE 5	TBD
SSRVACTION_TRACE 1	Provide debug trace information. The data parameter is a text string.

data

The format of this parameter depends on the value of the action parameter.

context

The context information provided by calling SymbolServerSetOptions with SSRVOPT_SETCONTEXT.

Return Value

To indicate success, return TRUE.

To indicate failure, return FALSE and call the SetLastError function to indicate an error condition. If you do not handle a particular action code, you should also return FALSE. (Returning TRUE in this case may have unintended consequences.)

Requirements

Redistributable	Requires DbgHelp.dll 5.1 or later.
Header	Declared in DbgHelp.h.

See Also

DbgHelp Functions
IMAGEHLP_CBA_EVENT

Send comments about this topic to Microsoft

Build date: 9/25/2007