共用方式為

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

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

Note 此方法可能會覆寫緩衝區的其餘部分，在傳回的字串之後。
 

[in] BufferSize

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

[out, optional] StringBytes

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

傳回值

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

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

言論

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

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）

另請參閱

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual