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

從目標接收字串。 如果 Buffer 是 NULL，則不會傳回這項資訊。

[in] BufferSize

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

[out, optional] StringBytes

接收目標中字串的大小，以位元組為單位。 如果 StringBytes 為 NULL，則不會傳回這項資訊。

傳回值

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

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

備註

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

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h、Winnls.h)

另請參閱

IDebugDataSpaces4

ReadMultiByteStringVirtual

ReadUnicodeStringVirtualWide