Método IExplorerBrowser::SetPropertyBag (shobjidl_core.h)

Define o nome do recipiente de propriedades.

Sintaxe

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Parâmetros

[in] pszPropertyBag

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode constante terminada em nulo que contém o nome do recipiente de propriedades. Exiba informações de estado específicas para o aplicativo do cliente são armazenadas (persistidas) usando esse nome.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

ExplorerBrowser pode recuperar as propriedades armazenadas no recipiente de propriedades chamando a função SHGetViewStatePropertyBag. ExplorerBrowser grava nesse recipiente de propriedades que também é armazenado (persistente) no registro. A persistência ocorre automaticamente quando ExplorerBrowser destrói o modo de exibição atual, inicia uma navegação ou é destruído. Após qualquer um desses eventos, ele grava informações sobre o estado de exibição caso tenha sido modificado pelo usuário.

Se nenhuma propriedade tiver sido armazenada, o estado de exibição padrão do ExplorerBrowser será usado. O estado de exibição padrão é o estado de exibição que o usuário definiu para um local específico ou se o estado de exibição de um local não tiver sido definido (nunca modificado pelo usuário), o estado de exibição padrão será baseado no modelo para o tipo de arquivo (por exemplo, documentos, músicas e imagens) no local. Todas as janelas Explorer usam a mesma sequência para determinar o estado de exibição padrão.

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)