GetSystemObjectInformation

The GetSystemObjectInformation method returns information about operating system objects on the target.

HRESULT
  IDebugAdvanced2::GetSystemObjectInformation(
    IN ULONG  Which,
    IN ULONG64  Arg64,
    IN ULONG  Arg32,
    OUT OPTIONAL PVOID  Buffer,
    IN ULONG  BufferSize,
    OUT OPTIONAL PULONG  InfoSize
    );

Parameters

Which

Specifies the type of object and the type of information to return about that object. Which can take the following value.

Value	Information returned
DEBUG_SYSOBJINFO_THREAD_BASIC_INFORMATION	Returns details of the thread specified by engine thread ID.

Arg64

Specifies a 64-bit argument. This parameter has the following interpretations depending on the value of Which:

DEBUG_SYSOBJINFO_THREAD_BASIC_INFORMATION

Not used.

Arg32

Specifies a 32-bit argument. This parameter has the following interpretations depending on the value of Which:

DEBUG_SYSOBJINFO_THREAD_BASIC_INFORMATION

The engine thread ID of the desired thread.

Buffer

Receives the requested information. The type of data returned in Buffer depends on the value of Which.

Value	Return type
DEBUG_SYSOBJINFO_THREAD_BASIC_INFORMATION	DEBUG_THREAD_BASIC_INFORMATION

BufferSize

Specifies the size, in bytes, of the buffer Buffer.

InfoSize

Receives the size of the information that is returned.

Return Value

S_OK

The method was successful.

S_FALSE

The method was successful. However, the information would not fit in the buffer Buffer, so the information was truncated.

This method may also return error values. See Return Values for more details.

Interface Version

GetSystemObjectInformation is available in IDebugAdvanced2 and later versions.

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

IDebugSystemObjects