Compartilhar via


Método ExtRemoteTyped::Set(PCSTR,ULONG64,bool,PULONG64,PCSTR) (engextcpp.hpp)

O método Set define os dados tipados representados pelo objeto ExtRemoteTyped .

Sintaxe

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

Parâmetros

[in] Type

O nome de tipo do tipo. O tipo pode incluir um qualificador de módulo – por exemplo, mymodule!mytype. O qualificador de módulo pode ser omitido, mas é recomendável que ele seja incluído se o módulo for conhecido.

[in] Offset

Especifica o local dos dados na memória do destino.

[in] PtrTo

Especifica se a instância ExtRemoteTyped deve ou não ser definida como os dados digitados especificados ou como um ponteiro para os dados digitados especificados. Se PtrTo for true, a instância ExtRemoteTyped será um ponteiro para os dados tipado.

[in, out, optional] CacheCookie

Um cookie de cache usado para armazenar em cache as informações de tipo. Se CacheCookie for NULL, o mecanismo de depurador procurará as informações de tipo sempre.

Um cookie de cache é um ponteiro para um ULONG64. Ele está associado a um símbolo específico que é identificado exclusivamente pela ID do tipo do símbolo e pelo endereço do módulo que contém o símbolo. Na primeira vez em que ele é usado, o ULONG64 para o qual o cookie de cache aponta deve ser definido como 0. Nesse caso, o mecanismo de depurador procurará as informações do símbolo e as armazenará em cache e, em seguida, definirá o cookie para que as informações do símbolo possam ser facilmente recuperadas posteriormente. Sempre que você usar um método subsequente que precisará de informações sobre o mesmo símbolo, use o cookie de cache. Em seguida, o mecanismo de depurador poderá recuperar as informações de símbolo do cache em vez de pesquisá-la. Cada cookie de cache só deve ser usado com um único tipo. Se um cookie de cache for usado em conjunto com um símbolo diferente, o cookie de cache poderá estar corrompido.

[in, optional] LinkField

O nome de um campo na estrutura de dados tipada que contém o ponteiro para o próximo item em uma lista. LinkField deverá ser definido se CacheCookie estiver sendo usado pela primeira vez e posteriormente será usado com ExtRemoteTypedList.

Retornar valor

Nenhum

Comentários

Retornos

Esse método não retorna um valor.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho engextcpp.hpp (inclua Engextcpp.hpp)

Confira também

ExtRemoteTyped

ExtRemoteTyped::Set (PCSTR)

ExtRemoteTyped::Set (PCSTR, ULONG64)

ExtRemoteTyped::Set (bool)

ExtRemoteTyped::SetPrint

ExtRemoteTypedList