IDebugControl4::GetTextReplacementWide メソッド (dbgeng.h)
GetTextReplacementWide メソッドは、ユーザー名のエイリアスまたは自動エイリアスの値を返します。
構文
HRESULT GetTextReplacementWide(
[in, optional] PCWSTR SrcText,
[in] ULONG Index,
[out, optional] PWSTR SrcBuffer,
[in] ULONG SrcBufferSize,
[out, optional] PULONG SrcSize,
[out, optional] PWSTR 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 の場合、この情報は返されません。
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
注釈
コマンドを実行するか、式を評価する前に、デバッガー エンジンは SrcBuffer で指定されたエイリアスをエイリアスの値 ( DstBuffer で指定) に置き換えます。
デバッガー エンジンで使用されるエイリアスの概要については、「エイリアスの使用」を参照してください。 デバッガー エンジン API でエイリアスを使用する方法の詳細については、「エンジン との対話」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |