ExtRemoteTyped::Set(PCSTR,ULONG64,bool,PULONG64,PCSTR) method (engextcpp.hpp)

Article
10/21/2021

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)