SHAddDefaultPropertiesByExt-Funktion (shobjidl.h)

Artikel
03/04/2024

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

Syntax

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

Parameter

[in] pszExt

Typ: PCWSTR

Ein Zeiger auf eine mit NULL endende 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 Fehlercode HRESULT zurückgegeben.

Hinweise

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. Der Liste wird "prop:" vorangestellt 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, der für den SetDefaultsFor Wert von HKEY_CLASSES_ROOT* gefunden wurde.

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:

Vom Dateisystem abgeleitete Eigenschaften (z. B. Größe und Erstellungsdatum)
Von der Datei abgeleitete Eigenschaften (z. B. Dimensionen und Anzahl der Seiten)
Eigenschaften, die in der Datei platziert werden (z. B. Autor und Tags)

Beim Erstellen einer neuen Datei werden die Typen 1 und 2 nur durch erstellen der Datei bereitgestellt. Eigenschaften des Typs 3 müssen jedoch explizit von einem Programm festgelegt werden. Das System stellt SHAddDefaultPropertiesByExt bereit, um Werte für bis zu drei spezifische Eigenschaften des Typs 3 bereitzustellen. Manchmal verwendet Windows Explorer diese API beim erstmaligen Speichern einer Datei oder beim Erstellen einer neuen Datei, nachdem die Menüauswahl Neu in einem Kontextmenü ausgewählt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h
DLL	Shell32.dll

Freigeben über