Compartilhar via

Função SHAddDefaultPropertiesByExt (shobjidl.h)

  • Artigo

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.

Retornar valor

Tipo: HRESULT

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

Comentários

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 de criação)
  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)
Ao criar um novo arquivo, os tipos um e dois são fornecidos apenas criando o arquivo. Mas as propriedades do tipo três devem ser definidas explicitamente por um programa. O sistema fornece SHAddDefaultPropertiesByExt para fornecer valores para até três propriedades específicas do tipo três. Às vezes, o Windows Explorer usa essa API ao salvar um arquivo pela primeira vez ou ao criar um novo arquivo após a escolha do menu Novo é selecionado em um menu de atalho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl.h
DLL Shell32.dll