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

從目標接收字串。 如果 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)

另請參閱

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual