DEVPROP_TYPE_NTSTATUS

DEVPROP_TYPE_NTSTATUS 識別碼代表 NTSTATUS.h 中定義的 NTSTATUS 狀態碼值的基礎資料型別識別碼。

Remarks

在Windows Vista及之後版本的 Windows,統一裝置屬性模型也為 Win32 錯誤碼值定義DEVPROP_TYPE_ERROR基礎資料型別識別碼Microsoft。

你只能用 DEVPROP_TYPEMOD_ARRAY 屬性-資料類型修飾符來組合DEVPROP_TYPE_NTSTATUS。

設定此類屬性

要設定一個基底資料型態為DEVPROP_TYPE_NTSTATUS的屬性,呼叫對應的 SetupDiSetXxx 屬性函式,並將函式輸入參數設為如下:

  • 將 PropertyType 參數設為 DEVPROP_TYPE_NTSTATUS。

  • 將 PropertyBuffer 參數設為指向緩衝區的指標,該緩衝區至少可包含一個 NTSTATUS 值。

  • 將 PropertyBufferSize 參數設為 sizeof(NTSTATUS)。

  • 根據適當的方式,設定剩餘的函式參數以設定該性質。

檢索描述性文字以取得 NTSTATUS 錯誤代碼值

要取得與 NTSTATUS 錯誤碼值相關的描述性文字,請呼叫 FormatMessage 函式(在 Windows SDK 中有文件說明):

  • 在 dwflags 參數的值中,包含 FORMAT_MESSAGE_FROM_SYSTEM 旗標與 FORMAT_MESSAGE_FROM_HMODULE 旗標的逐位元或。

  • 將 lpSource 參數設為 NtDLL.dll 模組的 handle,該模組是描述性文字的來源。

  • 將 dwMessageID 參數設為錯誤代碼值。

  • 請依照情況設定其他選項與參數,以取得描述性文字。

Requirements

Version

Windows Vista 及後續版本的 Windows。

頁首

Devpropdef.h(包含 Devpropdef.h)

也請參閱

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY