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

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

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 の場合、この情報は返されません。