IFileSaveDialog：：ApplyProperties 方法 (shobjidl_core.h)

使用Shell的複製引擎，將一組屬性套用至專案。

語法

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

參數

[in] psi

類型： IShellItem*

代表正在儲存之檔案的 IShellItem 指標。 這通常是 GetResult 所擷取的專案。

[in] pStore

類型： IPropertyStore*

IPropertyStore 的指標，代表要套用至檔案的屬性值。 這可以是 IFileSaveDialog：：GetProperties 所傳回的屬性存放區。

[in] hwnd

類型： HWND

應用程式視窗的句柄。

[in] pSink

類型： IFileOperationProgressSink*

選擇性 IFileOperationProgressSink 的指標，如果呼叫端應用程式想要收到屬性戳記進度的通知，可以使用該 IFileOperationProgressSink。 此值可以是 NULL。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當應用程式開啟屬性集合 (IFileSaveDialog：：SetCollectedProperties) 時，應該使用這個方法，但不會將屬性本身保存在已儲存的檔案中。

注意在呼叫 IFileSaveDialog：：ApplyProperties 之前，由 psi 中指定的專案所代表的檔案必須存在於實體記憶體中，因此必須先在某個時間點儲存它。

 

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h