IDebugSymbolGroup2::OutputAsType メソッド (dbgeng.h)

[アーティクル]
02/26/2024

OutputAsType メソッドは、シンボルグループ内のシンボルの種類を変更します。シンボルのエントリが更新され、新しい型が表されます。

構文

HRESULT OutputAsType(
  [in] ULONG Index,
  [in] PCSTR Type
);

パラメーター

[in] Index

このシンボルグループ内のエントリのインデックス。シンボルの インデックス は識別番号です。インデックスは、0 からシンボルグループ内のシンボルの数から 1 を引いた範囲です。

[in] Type

目的のシンボルの種類の名前。名前が感嘆符 (!) で始まる場合、名前は拡張子として扱われます。拡張機能を型として使用する方法の詳細については、「解説」セクションを参照してください。

戻り値

リターンコード	説明
S_OK	メソッドは正常に実行されました。

このメソッドは、エラー値を返すこともできます。詳細については、「戻り値」を参照してください。

注釈

新しいエントリの種類の子は、古いエントリの種類の子とは異なる場合があるため、 OutputAsType メソッドは、シンボルグループからエントリのすべての子を削除します。 ExpandSymbol メソッドを使用して、子を再度追加できます。

Type が拡張機能の場合、シンボルのアドレスが拡張機能に渡されます。拡張機能からの出力のすべての行は、指定されたシンボルの子シンボルになります。これらの子シンボルはテキストであり、どのような方法でも操作することはできません。たとえば、変数の名前が @$tebの場合、その型を !teb に変更できます。

シンボルグループの詳細については、「スコープとシンボルグループ」を参照してください。