共用方式為

IDebugDataSpaces4：：ReadMultiByteStringVirtual 方法 (dbgeng.h)

  • 發行項

ReadMultiByteStringVirtual 方法會從目標讀取以 Null 結尾的多位元組字串。

語法

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

參數

[in] Offset

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

[in] MaxBytes

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

[out, optional] Buffer

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

注意 在傳回的字串之後，緩衝區的其餘部分可能會由這個方法覆寫。
 

[in] BufferSize

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

[out, optional] StringBytes

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

傳回值

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

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

備註

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

規格需求

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

另請參閱

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual