次の方法で共有

DEVPROP_TYPE_EMPTY

  • [アーティクル]

Windows Vista 以降のバージョンの Windows では、DEVPROP_TYPE_EMPTY 識別子は特殊な基本データ型識別子を表しており、プロパティが存在しないことを示します。

解説

この基本データ型識別子をデバイスのプロパティ関数と共に使用すると、プロパティが削除されます。

デバイスのプロパティ関数からこの基本データ型識別子が返ってくる場合、プロパティは存在しません。

DEVPROP_TYPE_EMPTY は、プロパティ データ型修飾子 DEVPROP_TYPEMOD_ARRAY や DEVPROP_TYPEMOD_LIST と組み合わせることはできません。

プロパティを削除する

プロパティを削除するには、対応する SetupDiSetXxx プロパティ関数を呼び出し、関数パラメーターを次のように設定します。

  • PropertyType パラメーターを DEVPROP_TYPE_EMPTY に設定し、PropertyBuffer パラメーターを NULL に設定します。そして、PropertyBufferSize パラメーターを 0 に設定します。

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

DEVPROP_TYPE_EMPTY を使用して存在しないプロパティを削除しようとした場合、削除操作は失敗し、GetLastError の呼び出しは ERROR_NOT_FOUND を返します。

存在しないプロパティを取得する

SetupDiGetXxx プロパティ関数を呼び出して存在しないデバイス プロパティを取得しようとすると、失敗し、その後 GetLastError を呼び出すと ERROR_NOT_FOUND が返されます。 呼び出された SetupAPI プロパティ関数で、*PropertyType パラメーターが DEVPROP_TYPE_EMPTY に設定されます。

要件

ヘッダー

 Devpropdef.h (Devpropdef.h を含む)