Função SHSetDefaultProperties (shobjidl.h)

Aplica o conjunto padrão de propriedades em um item shell.

Sintaxe

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai do item, que recebe notificações de erro. Esse valor pode ser NULL.

[in] psi

Tipo: IShellItem*

Um ponteiro para o objeto IShellItem que representa o item.

dwFileOpFlags

Tipo: DWORD

Sinalizadores que personalizam a operação. Consulte IFileOperation::SetOperationFlags para obter valores de sinalizador.

[in, optional] pfops

Tipo: IFileOperationProgressSink*

Um ponteiro para um objeto IFileOperationProgressSink usado para acompanhar o progresso da operação. Consulte IFileOperation::Advise para obter detalhes. Esse valor pode ser NULL.

Valor retornado

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 para definir um valor padrão vem da entrada SetDefaultsFor registry no ProgID para a associação de arquivo do item. A lista é prefixada por "prop:" e contém os nomes canônicos das propriedades para definir o valor padrão, por exemplo, "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 a entrada SetDefaultsFor não existir no ProgID, essa função usará o padrão encontrado na entrada SetDefaultsFor de HKEY_CLASSES_ROOT\*.

Requisitos