SHAddDefaultPropertiesByExt 函式 (shobjidl.h)

  • 發行項

將預設屬性新增至屬性存放區，以註冊指定的擴展名。

語法

SHSTDAPI SHAddDefaultPropertiesByExt(
  [in] PCWSTR         pszExt,
  [in] IPropertyStore *pPropStore
);

參數

[in] pszExt

類型： PCWSTR

指定擴充功能的 Null 終止 Unicode 字串指標。

[in] pPropStore

類型： IPropertyStore*

IPropertyStore 介面的指標，定義要加入的默認屬性。

傳回值

類型： HRESULT

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

備註

用來設定預設值的屬性清單來自 SetDefaultsFor 指定擴展名之檔案關聯之 ProgID 的登錄值。 清單前面會加上 “prop:”，並包含設定預設值的屬性標準名稱，例如： “prop:System.Author;System.Document.DateCreated”。 此清單的可能屬性為 System.Author、 System.Document.DateCreated 和 System.Photo.DateTaken。 SetDefaultsFor如果 ProgID 上沒有值，此函式會使用在 HKEY_CLASSES_ROOT* 的值上SetDefaultsFor找到的預設值。

System.Author 具有執行動作的用戶值。 System.Document.DateCreated 和 System.Photo.DateTaken 會使用目前的日期。 這三個屬性是唯一系統提供特殊預設值的屬性。

請注意，有數種類型的屬性：

  1. 衍生自文件系統的屬性 (，例如建立的大小和日期)
  2. 衍生自檔案的屬性 (，例如維度和頁數)
  3. 放置在檔案中的屬性 (，例如作者和標記)
建立新檔案時，只要建立檔案，就會提供一和兩種類型的類型。 但第三種類型的屬性必須由程序明確設定。 系統會提供 SHAddDefaultPropertiesByExt ，以提供最多三種類型特定屬性的值。 有時候 Windows 檔案總管會在第一次儲存盤案時使用此 API，或在功能表選擇 [新增] 從快捷方式功能表中選取 [ 新增 ] 之後建立新檔案時。

規格需求

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