DEVPROP_TYPE_NTSTATUS

DEVPROP_TYPE_NTSTATUS識別子は、Ntstatus.h で定義されている NTSTATUS 状態コード値の基本データ型識別子を表します。

Remarks

WindowsのWindows Vista以降のバージョンでは、統合デバイス プロパティ モデルでは、Win32 エラー コード値のDEVPROP_TYPE_ERROR基本データ型識別子も定義Microsoft。

DEVPROP_TYPE_NTSTATUSは、 DEVPROP_TYPEMOD_ARRAY property-data-type 修飾子とのみ組み合わせることができます。

この型のプロパティの設定

基本データ型がDEVPROP_TYPE_NTSTATUSプロパティを設定するには、対応する SetupDiSetXxx プロパティ関数を呼び出し、関数の入力パラメーターを次のように設定します。

  • PropertyType パラメーターをDEVPROP_TYPE_NTSTATUSに設定します。

  • PropertyBuffer パラメーターを、少なくとも 1 つの NTSTATUS 値を含むことができるバッファーへのポインターに設定します。

  • PropertyBufferSize パラメーターを sizeof(NTSTATUS) に設定します。

  • プロパティを設定するには、必要に応じて残りの関数パラメーターを設定します。

NTSTATUS エラー コード値の説明テキストの取得

NTSTATUS エラー コード値に関連付けられている説明テキストを取得するには、次のように FormatMessage 関数 (Windows SDK に記載されています) を呼び出します。

  • FORMAT_MESSAGE_FROM_SYSTEM フラグのビットごとの OR と、FORMAT_MESSAGE_FROM_HMODULE フラグを 、値としてgs パラメーターに含めます。

  • lpSource パラメーターを、説明テキストのソースであるNtDLL.dllモジュールのハンドルに設定します。

  • dwMessageID パラメーターをエラー コード値に設定します。

  • 説明テキストを取得するには、必要に応じて他のオプションとパラメーターを設定します。

Requirements

Version

WindowsのWindows Vista以降のバージョン。

ヘッダー

Devpropdef.h (Devpropdef.h を含む)

参照

DEVPROP_TYPE_ERROR

DEVPROP_TYPEMOD_ARRAY