Função SHSetTemporaryPropertyForItem (shobjidl_core.h)

Define uma propriedade temporária para o item especificado. Uma propriedade temporária é mantida em um repositório de leitura/gravação que contém propriedades somente durante o tempo de vida do objeto IShellItem , em vez de gravá-las novamente no item.

Sintaxe

SHSTDAPI SHSetTemporaryPropertyForItem(
  [in] IShellItem     *psi,
  [in] REFPROPERTYKEY propkey,
  [in] REFPROPVARIANT propvar
);

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o item no qual a propriedade temporária deve ser definida.

[in] propkey

Tipo: REFPROPERTYKEY

Referência à PROPERTYKEY que identifica a propriedade temporária que está sendo definida.

[in] propvar

Tipo: REFPROPVARIANT

Referência a um PROPVARIANT que contém o valor da propriedade temporária.

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

Um valor temporário só pode ser lido com SHGetTemporaryPropertyForItem ou passando GPS_TEMPORARY para IShellItem2::GetPropertyStore.

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_core.h (inclua Shobjidl.h)
Biblioteca Shell32.lib
DLL Shell32.dll