次の方法で共有

IDebugControl3::GetTextReplacement メソッド (dbgeng.h)

  • [アーティクル]

GetTextReplacement メソッドは、ユーザー名のエイリアスまたは自動エイリアスの値を返します。

構文

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

パラメーター

[in, optional] SrcText

エイリアスの名前を指定します。 エンジンは、最初にユーザー名のエイリアスを検索して、この名前を持つエイリアスを検索します。 一致するものが見つからない場合は、自動エイリアスが検索されます。 SrcText NULL 場合は、Index を使用してエイリアスを指定します。

[in] Index

エイリアスのインデックスを指定します。 ユーザー名のエイリアスのインデックスは、自動エイリアスのインデックスの前にあります。 Index は、srcText が NULL 場合にのみ使用されます。 Index は、GetNumberTextReplacements と共に使用して、ユーザー名と自動のすべてのエイリアスを反復処理できます。

[out, optional] SrcBuffer

エイリアスの名前を受け取ります。 SrcText が NULL でない場合、これは srcText で指定 名前です。 SrcBuffer が NULL 場合、この情報は返されません。

[in] SrcBufferSize

SrcBuffer バッファーのサイズを文字で指定します。

[out, optional] SrcSize

エイリアスの名前のサイズを文字で受け取ります。 SrcSize が NULL 場合、この情報は返されません。

[out, optional] DstBuffer

SrcText および Indexで指定されたエイリアスの値 受け取ります。 DstBuffer が NULL 場合、この情報は返されません。

[in] DstBufferSize

DstBuffer バッファーのサイズを文字で指定します。

[out, optional] DstSize

エイリアスの値のサイズを文字単位で受け取ります。 DstSize が NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。

備考

コマンドの実行または式の評価を行う前に、デバッガー エンジンは、srcBuffer で指定されたエイリアスをエイリアスの値 (DstBuffer で指定) に置き換えます。

デバッガー エンジンので使用されるエイリアスの概要については、「エイリアスの使用」を参照してください。 デバッガー エンジン API でエイリアスを使用する方法の詳細については、「エンジンとの対話」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

GetNumberTextReplacements の

GetTextMacro の

IDebugControl2 の

IDebugControl3 の

OutputTextReplacements の

SetTextReplacement の

al (リスト エイリアス)