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

ターゲットから文字列を受け取ります。 バッファー が NULL 場合、この情報は返されません。

メモ 返された文字列に続くバッファーの残りの部分は、このメソッドによって上書きされる可能性があります。
 

[in] BufferSize

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

[out, optional] StringBytes

文字列のサイズ (バイト単位) を受け取ります。 StringBytes が NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
S_FALSE
 メソッドが成功しました。 ただし、バッファー は文字列を保持するのに十分な大きさではなく、バッファー に収まるように文字列切り捨てられました。 Buffer に少なくとも 1 文字のスペースがある場合、切り捨てられた文字列は null で終了します。
E_INVALIDARG
 ターゲットから MaxBytes 読み取った後、null ターミネータが見つかりませんでした。
 

メソッドが成功しました。

備考

エンジンは、ターゲットから最大 MaxBytes を読み取り、null ターミネータを探します。 文字列に BufferSize 文字を超える文字が含まれている場合は、バッファー に収まるように文字列切り捨てられます。

必要条件

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

関連項目

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

  • Last updated on