SHSetDefaultProperties 函式 (shobjidl.h)
在 Shell 專案上套用預設的屬性集。
語法
SHSTDAPI SHSetDefaultProperties(
[in, optional] HWND hwnd,
[in] IShellItem *psi,
DWORD dwFileOpFlags,
[in, optional] IFileOperationProgressSink *pfops
);
參數
[in, optional] hwnd
類型: HWND
專案的父視窗控制碼,可接收錯誤通知。 此值可以是 Null。
[in] psi
類型: IShellItem*
代表專案的 IShellItem 物件的指標。
dwFileOpFlags
類型: DWORD
自訂作業的旗標。 如需旗標值,請參閱 IFileOperation::SetOperationFlags 。
[in, optional] pfops
類型: IFileOperationProgressSink*
IFileOperationProgressSink物件的指標,用來追蹤作業的進度。 如需詳細資訊 ,請參閱 IFileOperation::建議 。 此值可以是 Null。
傳回值
類型: HRESULT
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
要設定預設值的屬性清單來自專案之檔案關聯之 ProgID 下的 SetDefaultsFor 登錄專案。 清單前面會加上 「 prop:
」,並包含屬性標準名稱,以設定預設值,例如 「 prop:System.Author;System.Document.DateCreated
」。 此清單的可能屬性包括 System.Author、 System.Document.DateCreated和 System.Photo.DateTaken。 如果 ProgID 上沒有SetDefaultsFor專案,此函式會使用在 HKEY_CLASSES_ROOT\*的 SetDefaultsFor專案上找到的預設 。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl.h |
程式庫 | Shell32.lib |
Dll | Shell32.dll |