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

Set 方法设置由 ExtRemoteTyped 对象表示的类型化数据。

语法

void Set(
  [in]                PCSTR    Type,
  [in]                ULONG64  Offset,
  [in]                bool     PtrTo,
  [in, out, optional] PULONG64 CacheCookie,
  [in, optional]      PCSTR    LinkField
);

参数

[in] Type

类型的类型名称。 类型 可以包含模块限定符,例如 mymodule!mytype。 可以省略模块限定符,但如果模块已知,则建议将其包含在内。

[in] Offset

指定数据在目标内存中的位置。

[in] PtrTo

指定是将 ExtRemoteTyped 实例设置为指定的类型化数据,还是设置为指向指定类型化数据的指针。 如果 PtrTotrue,则 ExtRemoteTyped 实例将是指向类型化数据的指针。

[in, out, optional] CacheCookie

用于缓存类型信息的缓存 Cookie。 如果 CacheCookieNULL,则调试器引擎将每次搜索类型信息。

缓存 Cookie 是指向ULONG64的指针。 它与由符号的类型 ID 和包含符号的模块地址唯一标识的特定符号相关联。 首次使用 Cookie 时,缓存 Cookie 指向ULONG64必须设置为 0。 在这种情况下,调试器引擎将搜索符号信息并将其缓存,然后设置 Cookie,以便以后可以轻松检索符号信息。 每当使用需要有关同一符号信息的后续方法时,请使用缓存 Cookie。 然后,调试器引擎将能够从缓存中检索符号信息,而不是搜索它。 每个缓存 Cookie 只能与单个类型一起使用。 如果缓存 Cookie 与其他符号结合使用,则缓存 Cookie 可能已损坏。

[in, optional] LinkField

类型化数据结构中包含指向列表中下一项的指针的字段的名称。 如果第一次使用 CacheCookie 并且稍后将用于 ExtRemoteTypedList,则应设置 LinkField

返回值

备注

返回

此方法不返回值。

要求

要求
目标平台 桌面
标头 engextcpp.hpp (包括 Engextcpp.hpp)

另请参阅

ExtRemoteTyped

ExtRemoteTyped::Set (PCSTR)

ExtRemoteTyped::Set (PCSTR,ULONG64)

ExtRemoteTyped::Set (bool)

ExtRemoteTyped::SetPrint

ExtRemoteTypedList