Função SHAddDefaultPropertiesByExt (shobjidl.h)

Adiciona propriedades padrão ao repositório de propriedades conforme registrado para a extensão de arquivo especificada.

Sintaxe

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

Parâmetros

[in] pszExt

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica a extensão.

[in] pPropStore

Tipo: IPropertyStore*

Um ponteiro para a interface IPropertyStore que define as propriedades padrão a serem adicionadas.

Valor de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

A lista de propriedades usadas para definir um valor padrão vem do SetDefaultsFor valor do Registro do ProgID para a associação de arquivo da extensão de arquivo especificada. A lista é prefixada por "prop:" e contém os nomes canônicos das propriedades para definir o valor padrão, como: "prop:System.Author;System.Document.DateCreated". As propriedades possíveis para essa lista são System.Author, System.Document.DateCreated e System.Photo.DateTaken. Se o SetDefaultsFor valor não existir no ProgID, essa função usará o padrão encontrado no SetDefaultsFor valor de HKEY_CLASSES_ROOT*.

System.Author tem o valor do usuário que executou a ação. System.Document.DateCreated e System.Photo.DateTaken usam a data atual. Essas três propriedades são as únicas para as quais o sistema fornece padrões especiais.

Observe que há vários tipos de propriedades:

1. Propriedades que derivam do sistema de arquivos (como tamanho e data criadas)
2. Propriedades que derivam do arquivo (como, dimensões e número de páginas)
3. Propriedades que são colocadas no arquivo (como, autor e marcas)

Requirements