物件屬性

Windows 可攜式裝置支援下列物件屬性。

屬性 VarType Description
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN 類型為 IPortableDevicePropVariantCollection VT_LPWSTR指出 ObjectID 的清單。 例如,當容器物件參考物件時,播放清單所參考的音訊物件,參考的物件會使用這個屬性來參考其容器物件。 音訊物件可能會參考此範例中的播放清單物件。
WPD_OBJECT_CAN_DELETE VT_BOOL 布林值,指定是否可以刪除指定的物件。
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR 包含此物件之最接近功能物件的物件識別碼。 例如,儲存體功能物件內的檔案會將此屬性設定為儲存體功能物件的識別碼。
WPD_OBJECT_CONTENT_TYPE VT_CLSID 識別此物件的泛型型別的 GUID ,例如檔或電子郵件。 這可以是 Windows 可攜式裝置或自訂驅動程式內容類型所定義的物件類型。 裝置物件是唯一不會報告這個屬性的物件。
WPD_OBJECT_DATE_AUTHORED VT_DATE 值,指定建立內容的日期和時間。 這可能與檔案的建立日期不同。 例如,音樂檔案的撰寫日期是錄製音樂的日期,但實際在裝置上建立 WMA 檔案的建立日期。
WPD_OBJECT_DATE_CREATED VT_DATE 值,指定在裝置上建立物件的日期和時間。
WPD_OBJECT_DATE_MODIFIED VT_DATE 值,指定物件在裝置上修改的日期和時間。
WPD_OBJECT_FORMAT VT_CLSID 識別物件資料格式的 GUID 。 這可以是 Windows 可攜式裝置 或自訂驅動程式格式所定義的格式。
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL 布林值,指定是否應該從預設資源資料建立這個物件的縮圖影像。這可為沒有縮圖資源的物件提供一種方式,以提供更方便的流覽體驗。 使用此旗標可能會影響第一個顯示回應,因為應用程式必須從裝置擷取和計算縮圖影像;盡可能提供個別的縮圖影像資源會更有效率。
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR 如果指定的物件顯示為提示位置,這個屬性會指出要顯示的提示特定名稱,而不是物件名稱。 驅動程式可以指定各種內容類型的位置提示。 您可以將這些視為包含指定型別物件的最上層資料夾物件的快捷方式。 使用這些位置提示的用戶端可以顯示與資料夾物件名稱不同的這些快捷方式名稱。 如果這個屬性不存在,通常會改用 WPD_OBJECT_NAME
WPD_OBJECT_ID VT_LPWSTR 可唯一識別裝置上物件的字串識別碼。 此識別碼不需要儲存在會話之間。如果此屬性同時是唯一且持續性的,驅動程式可能會同時將 WPD_OBJECT_PERSISTENT_UNIQUE_IDWPD_OBJECT_ID 設定為相同的值。
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL 布林值,指定媒體資料是否受到 DRM 保護。 如果不存在,則會假設這是 False。
WPD_OBJECT_ISHIDDEN VT_BOOL 布林值,指定是否應該隱藏物件。 如果不存在,則會假設物件不會隱藏。
WPD_OBJECT_CAN_DELETE VT_BOOL 布林值,指定是否可以刪除物件。
WPD_OBJECT_ISSYSTEM VT_BOOL 布林值,指定 物件是否代表系統資料 (,例如系統檔案) 。 如果不存在,則會假設物件不是系統物件。
WPD_OBJECT_KEYWORDS VT_LPWSTR 字串,其中包含與此物件相關聯的空格分隔關鍵字清單。
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR 字串,表示指定物件所使用的語言。 如果這個物件中包含多種語言,它應該識別主要語言。 此屬性可能包含語言代碼,如 ISO-639 中所定義,例如:「en」。 它也可能包含語言國家/地區代碼,其中包含兩或三個字元的語言代碼,如 ISO-639 標準中所定義,後面接著連字號,然後接著 ISO-3166 中所定義的國家/地區代碼,例如:「en-US」。
WPD_OBJECT_NAME VT_LPWSTR 物件的顯示名稱。
WPD_OBJECT_NON_CONSUMABLE VT_BOOL 布林值,指定此物件是要瞭解或只由裝置儲存。 如果這個屬性不存在,則會假設所有資料都用於取用。
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR 檔案的字串名稱。
WPD_OBJECT_PARENT_ID VT_LPWSTR 父物件的物件識別碼。 唯一可以傳回此值空白字串的物件是根裝置物件。若要修改此屬性,請呼叫 IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE) 。
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR 可唯一識別裝置上物件的字串識別碼,類似于 WPD_OBJECT_ID,但必須在會話之間儲存。如果物件識別碼 WPD_OBJECT_ID 是唯一且持續性的,驅動程式可能會同時將 WPD_OBJECT_PERSISTENT_UNIQUE_IDWPD_OBJECT_ID 設定為相同的值。
WPD_OBJECT_REFERENCES VT_UNKNOWN IPortableDevicePropVariantCollection,其中包含識別參考物件的VT_LPWSTR物件識別碼集合。 只有在物件是資料夾或播放清單等參考物件時,才需要此專案。
WPD_OBJECT_SIZE VT_UI8 物件資源資料的大小。
WPD_OBJECT_SYNC_ID VT_LPWSTR 用戶端建立的不透明字串,可在會話之間保留狀態,而不會保留連線裝置內容的目錄。

規格需求

需求
標頭
PortableDevice.h

另請參閱

WPD 屬性和屬性