共用方式為


IDebugDataSpaces4::ReadUnicodeStringVirtual 方法 (dbgeng.h)

ReadUnicodeStringVirtual 方法會從目標讀取以 Null 結束的 Unicode 字串,並將其轉換成多位元組位元串。

語法

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

參數

[in] Offset

指定行程虛擬位址空間中字串的位置。

[in] MaxBytes

指定要從目標讀取的最大位元元組數目。

[in] CodePage

指定要用來將從目標讀取的多位元組位元串轉換成 Unicode 字串的代碼頁。 例如,CP_ACP是 ANSI 代碼頁。

[out, optional] Buffer

從目標接收字串。 如果 緩衝區NULL,則不會傳回此資訊。

[in] BufferSize

指定 緩衝區 緩衝區的大小,以字元為單位。

[out, optional] StringBytes

接收目標中字串的大小,以位元組為單位。 如果 StringBytesNULL,則不會傳回此資訊。

傳回值

傳回碼 描述
S_OK
方法成功。
S_FALSE
方法成功。 不過,Buffer 不夠大,無法保存字串,而且字串已截斷,以容納 Buffer。 如果 緩衝區 至少有一個字元的空間,則截斷字串會以 null 結束。
E_INVALIDARG
從目標讀取 MaxBytes 之後,找不到 null 終止符。
 

這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值

言論

引擎會從目標讀取最多 MaxBytes,並尋找 null 終止符。 如果字串有超過 BufferSize 字元,字串將會截斷以符合 Buffer

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h (包括 Dbgeng.h、Winnls.h)

另請參閱

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide