DEVPROP_TYPE_EMPTY

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

Remarks

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

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

DEVPROP_TYPE_EMPTYDEVPROP_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に設定します。

Requirements

ヘッダー

Devpropdef.h (Devpropdef.h を含む)