Debugging Tools for Windows

DebugExtensionQueryValueNames

The DebugExtensionQueryValueNames callback function recovers pseudo-register values.

HRESULT CALLBACK
  DebugExtensionQueryValueNames (
    __in PDEBUG_CLIENT  Client,
    __in ULONG  Flags,
    __out_ecount(BufferChars) PWSTR  Buffer,
    __in ULONG  BufferChars,
    __out PULONG  BufferNeeded
    );

Parameters

Client
A client to use if the extension needs DbgEng functions.

Flags
Provides behavioral flags. This parameter is currently reserved.

Buffer
A string buffer that the caller provides, to be filled with the set of value names that the client wants to expose.

BufferChars
The count of wide characters in Buffer.

BufferNeeded
The number of wide characters that this function needs to complete successfully.

Return Value

DebugExtensionQueryValueNames might return one of the following values:

S_OK
The function was successfully completed.
S_FALSE
The function completed without error, but it obtained only partial results.

This function might also return error values. For more information about possible return values, see Return Values.

Comments

Value names must start with $$ and have a terminating NULL character. The Buffer string must also be NULL-terminated. For example, Buffer could be “$$myval1\0$$myval2\0\0”.

Requirements

Headers: The Dbgeng.h header file has the definitions of the callback prototypes.

See Also

DebugExtensionInitialize, DebugExtensionNotify, DebugExtensionProvideValue, DebugExtensionUninitialize, KnownStructOutput

Build machine: CAPEBUILD