IDebugDataSpaces4::ReadUnicodeStringVirtualWide メソッド (dbgeng.h)
ReadUnicodeStringVirtualWide メソッドは、null で終わる Unicode 文字列をターゲットから読み取ります。
構文
HRESULT ReadUnicodeStringVirtualWide(
[in] ULONG64 Offset,
[in] ULONG MaxBytes,
[out, optional] PWSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG StringBytes
);
パラメーター
[in] Offset
プロセスの仮想アドレス空間内の文字列の場所を指定します。
[in] MaxBytes
ターゲットから読み取る最大バイト数を指定します。
[out, optional] Buffer
ターゲットから文字列を受け取ります。 Buffer が NULL の場合、この情報は返されません。
メモ 返された文字列の後のバッファーの残りの部分は、このメソッドによって上書きされる可能性があります。
[in] BufferSize
バッファー バッファーのサイズを文字数で指定します。
[out, optional] StringBytes
文字列のサイズ (バイト単位) を受け取ります。 StringBytes が NULL の場合、この情報は返されません。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
|
|
メソッドは正常に実行されました。 ただし、 Buffer は文字列を保持するのに十分な大きさではなく、文字列は Buffer に収まるように切り捨てられました。 Buffer に少なくとも 1 文字のスペースがある場合、切り捨てられた文字列は null で終わる。 |
|
ターゲットから MaxBytes を読み取った後に null 終端記号が見つかりませんでした。 |
メソッドは正常に実行されました。
注釈
エンジンはターゲットから 最大 MaxBytes を読み取り、null 終端記号を探します。 文字列に BufferSize 文字を超える文字が含まれている場合、文字列は Buffer に収まるように切り捨てられます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |