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 实例设置为指定的类型化数据,还是设置为指向指定类型化数据的指针。 如果 PtrTo 为 true
,则 ExtRemoteTyped 实例将是指向类型化数据的指针。
[in, out, optional] CacheCookie
用于缓存类型信息的缓存 Cookie。 如果 CacheCookie 为 NULL,则调试器引擎将每次搜索类型信息。
缓存 Cookie 是指向ULONG64的指针。 它与由符号的类型 ID 和包含符号的模块地址唯一标识的特定符号相关联。 首次使用 Cookie 时,缓存 Cookie 指向ULONG64必须设置为 0。 在这种情况下,调试器引擎将搜索符号信息并将其缓存,然后设置 Cookie,以便以后可以轻松检索符号信息。 每当使用需要有关同一符号信息的后续方法时,请使用缓存 Cookie。 然后,调试器引擎将能够从缓存中检索符号信息,而不是搜索它。 每个缓存 Cookie 只能与单个类型一起使用。 如果缓存 Cookie 与其他符号结合使用,则缓存 Cookie 可能已损坏。
[in, optional] LinkField
类型化数据结构中包含指向列表中下一项的指针的字段的名称。 如果第一次使用 CacheCookie 并且稍后将用于 ExtRemoteTypedList,则应设置 LinkField。
返回值
无
备注
返回
此方法不返回值。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | engextcpp.hpp (包括 Engextcpp.hpp) |