SHAddDefaultPropertiesByExt-Funktion (shobjidl.h)

Fügt dem Eigenschaftenspeicher Standardeigenschaften hinzu, die für die angegebene Dateierweiterung registriert sind.

Syntax

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

Die Parameter

[in] pszExt

Typ: PCWSTR-

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die die Erweiterung angibt.

[in] pPropStore

Typ: IPropertyStore*

Ein Zeiger auf die IPropertyStore-Schnittstelle , die die hinzuzufügenden Standardeigenschaften definiert.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Die Liste der Eigenschaften, die zum Festlegen eines Standardwerts verwendet werden, stammt aus dem SetDefaultsFor Registrierungswert der ProgID für die Dateizuordnung der angegebenen Dateierweiterung. Die Liste wird mit dem Präfix "prop:" versehen und enthält die kanonischen Namen der Eigenschaften, um den Standardwert festzulegen, z. B. "prop:System.Author;System.Document.DateCreated". Die möglichen Eigenschaften für diese Liste sind System.Author, System.Document.DateCreated und System.Photo.DateTaken. Wenn der SetDefaultsFor Wert für die ProgID nicht vorhanden ist, verwendet diese Funktion den Standardwert für den SetDefaultsFor Wert HKEY_CLASSES_ROOT*.

System.Author hat den Wert des Benutzers, der die Aktion ausgeführt hat. System.Document.DateCreated und System.Photo.DateTaken verwenden das aktuelle Datum. Diese drei Eigenschaften sind die einzigen Eigenschaften, für die das System spezielle Standardwerte bereitstellt.

Beachten Sie, dass es mehrere Arten von Eigenschaften gibt:

1. Eigenschaften, die vom Dateisystem abgeleitet werden (z. B. Größe und Erstellungsdatum)
2. Eigenschaften, die von der Datei abgeleitet werden (z. B. Dimensionen und Anzahl von Seiten)
3. Eigenschaften, die in die Datei eingefügt werden (z. B. Autor und Tags)

Anforderungen