ExtRemoteTyped::Set(PCSTR,ULONG64,bool,PULONG64,PCSTR) method (engextcpp.hpp)
The Set method sets the typed data represented by the ExtRemoteTyped object.
Syntax
void Set(
[in] PCSTR Type,
[in] ULONG64 Offset,
[in] bool PtrTo,
[in, out, optional] PULONG64 CacheCookie,
[in, optional] PCSTR LinkField
);
Parameters
[in] Type
The type name of the type. Type can include a module qualifier--for example, mymodule!mytype. The module qualifier can be omitted, but it is recommended that it be included if the module is known.
[in] Offset
Specifies the location of the data in the target's memory.
[in] PtrTo
Specifies whether or not to set the ExtRemoteTyped instance to the specified typed data, or to a pointer to the specified typed data. If PtrTo is true
, the ExtRemoteTyped instance will be a pointer to the typed data.
[in, out, optional] CacheCookie
A cache cookie used for caching the type information. If CacheCookie is NULL, the debugger engine will search for the type information each time.
A cache cookie is a pointer to a ULONG64. It is associated with a particular symbol that is uniquely identified by the symbol's type ID and the address of the module that contains the symbol. The first time it is used, the ULONG64 that cache cookie points to must be set to 0. In this case, the debugger engine will search for the symbol information and cache it, then it will set the cookie so that the symbol information can be easily retrieved later. Whenever you use a subsequent method that will need information about the same symbol, use the cache cookie. The debugger engine will then be able to retrieve the symbol information from the cache instead of searching for it. Each cache cookie should only be used with a single type. If a cache cookie is used in conjunction with a different symbol, the cache cookie might be corrupted.
[in, optional] LinkField
The name of a field in the typed data structure which contains the pointer to the next item in a list. LinkField should be set if CacheCookie is being used for the first time and will later be used with ExtRemoteTypedList.
Return value
None
Remarks
Returns
This method does not return a value.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | engextcpp.hpp (include Engextcpp.hpp) |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for