IDebugControl4::GetLastEventInformationWide method (dbgeng.h)
The GetLastEventInformationWide method returns information about the last event that occurred in a target.
Syntax
HRESULT GetLastEventInformationWide(
[out] PULONG Type,
[out] PULONG ProcessId,
[out] PULONG ThreadId,
[out, optional] PVOID ExtraInformation,
[in] ULONG ExtraInformationSize,
[out, optional] PULONG ExtraInformationUsed,
[out, optional] PWSTR Description,
[in] ULONG DescriptionSize,
[out, optional] PULONG DescriptionUsed
);
Parameters
[out] Type
Receives the type of the last event generated by the target. For a list of possible types, see DEBUG_EVENT_XXX.
[out] ProcessId
Receives the process ID of the process in which the event occurred. If this information is not available, DEBUG_ANY_ID will be returned instead.
[out] ThreadId
Receives the thread ID of the thread in which the last event occurred. If this information is not available, DEBUG_ANY_ID will be returned instead.
[out, optional] ExtraInformation
Receives extra information about the event. The contents of this extra information depends on the type of the event as indicated by the returned Type parameter. For example, if Type is breakpoint, ExtraInformation contains a DEBUG_LAST_EVENT_INFO_BREAKPOINT; if Type is Exception, ExtraInformation contains a DEBUG_LAST_EVENT_INFO_EXCEPTION. Refer to DEBUG_EVENT_XXX for the complete list of event types and the dbgeng.h header file for the structure definitions for each event type.
If ExtraInformation is NULL, this information is not returned.
[in] ExtraInformationSize
Specifies the size, in bytes, of the buffer that ExtraInformation specifies.
[out, optional] ExtraInformationUsed
Receives the size, in bytes, of extra information. If ExtraInformationUsed is NULL, this information is not returned.
[out, optional] Description
Receives the description of the event. If Description is NULL, this information is not returned.
[in] DescriptionSize
Specifies the size, in characters, of the buffer that Description specifies. This size includes the space for the '\0' terminating character.
[out, optional] DescriptionUsed
Receives the size in characters of the description of the event. This size includes the space for the '\0' terminating character. If DescriptionUsed is NULL, this information is not returned.
Return value
This method may also return error values. See Return Values for more details.
Return code | Description |
---|---|
|
The method was successful. |
|
The method was successful. However, either ExtraInformationSize or DescriptionSize were smaller that the size of the respective data or string and the data or string was truncated to fit inside the buffer. |
Remarks
For thread and process creation events, the thread ID and process ID returned to ThreadId and ProcessId are for the newly created thread or process.
For more information about the last event, see the topic Event Information.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (include Dbgeng.h) |