DEVPROP_TYPE_EMPTY

在 Windows Vista 和更新版本的 Windows 中,DEVPROP_TYPE_EMPTY識別碼代表特殊基底資料類型識別碼,指出屬性不存在。

備註

使用此 base-data-type 識別碼搭配裝置屬性函式來刪除屬性。

如果裝置屬性函式傳回這個 base-data-type 識別碼,則屬性不存在。

DEVPROP_TYPE_EMPTY無法與屬性資料類型修飾詞DEVPROP_TYPEMOD_ARRAY或DEVPROP_TYPEMOD_LIST結合。

刪除屬性

若要刪除屬性,請呼叫對應的 SetupDiSetXxx 屬性函式,並設定函式參數,如下所示:

  • PropertyType 參數設定為 DEVPROP_TYPE_EMPTY、 PropertyBuffer 參數設定為 Null,並將 PropertyBufferSize 參數設定為零。

  • 視需要設定其他函式輸入參數來設定 屬性。

如果嘗試刪除不存在的屬性時使用DEVPROP_TYPE_EMPTY,刪除作業將會失敗,而且 對 GetLastError 的呼叫將會傳回ERROR_NOT_FOUND。

擷取不存在的屬性

嘗試擷取不存在之裝置屬性的 SetupDiGetXxx 屬性函式呼叫將會失敗,且 後續呼叫 GetLastError 會傳回ERROR_NOT_FOUND。 稱為 SetupAPI 屬性函式會將 *PropertyType 參數設定為 DEVPROP_TYPE_EMPTY。

規格需求

標頭

Devpropdef.h (包含 Devpropdef.h)