Funzione SHAddDefaultPropertiesByExt (shobjidl.h)

Articolo
08/26/2023

Aggiunge le proprietà predefinite all'archivio delle proprietà come registrato per l'estensione di file specificata.

Sintassi

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

Parametri

[in] pszExt

Tipo: PCWSTR

Puntatore a una stringa Unicode con terminazione Null che specifica l'estensione.

[in] pPropStore

Tipo: IPropertyStore*

Puntatore all'interfaccia IPropertyStore che definisce le proprietà predefinite da aggiungere.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'elenco delle proprietà usate per impostare un valore predefinito deriva dal SetDefaultsFor valore del Registro di sistema di ProgID per l'associazione di file dell'estensione file specificata. L'elenco è preceduto da "" e contiene i nomi canonici delle proprietà per impostare il valore predefinito, ad esempio : "prop:prop:System.Author;System.Document.DateCreated". Le possibili proprietà per questo elenco sono System.Author, System.Document.DateCreated e System.Photo.DateTaken. Se il SetDefaultsFor valore non esiste nel ProgID, questa funzione usa il valore predefinito trovato sul SetDefaultsFor valore di HKEY_CLASSES_ROOT*.

System.Author ha il valore dell'utente che ha eseguito l'azione. System.Document.DateCreated e System.Photo.DateTaken usano la data corrente. Queste tre proprietà sono le uniche per le quali il sistema fornisce impostazioni predefinite speciali.

Si noti che esistono diversi tipi di proprietà:

Proprietà che derivano dal file system (ad esempio, dimensioni e data create)
Proprietà che derivano dal file ( ad esempio, dimensioni e numero di pagine)
Proprietà inserite nel file ,ad esempio, autore e tag)

Quando si crea un nuovo file, i tipi uno e due vengono forniti solo creando il file. Tuttavia, le proprietà di tipo tre devono essere impostate in modo esplicito da un programma. Il sistema fornisce SHAddDefaultPropertiesByExt per fornire valori per un massimo di tre proprietà specifiche di tipo tre. In alcuni casi Esplora risorse usa questa API quando si salva un file per la prima volta o quando si crea un nuovo file dopo che viene selezionata la scelta di menu Nuovo da un menu di scelta rapida.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl.h
DLL	Shell32.dll

Condividi tramite