IDebugControl4：：OutputWide 方法（dbgeng.h）

OutputWide 方法會格式化字串，並將結果傳送至已向引擎客戶端註冊輸出回呼。

語法

HRESULT OutputWide(
  [in] ULONG  Mask,
  [in] PCWSTR Format,
       ...    
);

[in] Mask

指定輸出類型位欄位。如需可能的值，請參閱 DEBUG_OUTPUT_XXX。

[in] Format

指定格式字串，如 printf中所示。一般而言，轉換字元的運作方式與 C 完全相同。對於浮點轉換字元，除非使用 l l 修飾詞，否則 64 位自變數會解譯為 32 位浮點數。

支援 %p 轉換字元，但它代表目標地址空間中的指標。它不能有任何修飾詞，而且會使用調試程式的內部位址格式。支援下列額外的轉換字元。

字元	自變數類型	論點	列印的文字
%p	ULONG64	地址空間中的指標	指標的值。
%N	DWORD_PTR （32 或 64 位，視主機的架構而定）	主機虛擬位址空間中的指標	指標的值。（這相當於標準 C %p 字元。
%I	ULONG64	任何 64 位值	指定的值。如果此值大於0xFFFFFFFF，則會列印為64位值。否則，它會列印為32位值。
%ma	ULONG64	進程虛擬位址空間中以 NULL 終止的 ASCII 字串位址	指定的字串。
%mu	ULONG64	進程虛擬位址空間中以 NULL 終止的 Unicode 字串位址	指定的字串。
%msa	ULONG64	進程虛擬位址空間中ANSI_STRING結構的位址	指定的字串。
%msu	ULONG64	進程虛擬位址空間中UNICODE_STRING結構的位址	指定的字串。
%y	ULONG64	具有符號資訊之專案的處理程式虛擬位址空間中的位址	包含指定符號名稱的字串（如果有的話，則為位移）。
%ly	ULONG64	具有符號資訊之專案的處理程式虛擬位址空間中的位址	字串，包含指定符號的名稱（以及任何位移，如果有的話），以及任何可用的源行資訊。

...

指定要在格式化期間插入輸出值的其他參數。

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

傳回碼	描述
S_OK	方法成功。

產生非常大的輸出字串時，可以達到調試程式引擎或作系統的限制。例如，某些版本的調試程式引擎具有單一輸出的 16K 字元限制。如果您發現非常大的輸出遭到截斷，您可能需要將輸出分割成多個要求。

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