Compartilhar via

Método IFileDialog::SetClientGuid (shobjidl_core.h)

  • Artigo

Permite que um aplicativo de chamada associe um GUID ao estado persistente de uma caixa de diálogo.

Sintaxe

HRESULT SetClientGuid(
  [in] REFGUID guid
);

Parâmetros

[in] guid

Tipo: REFGUID

O GUID a ser associado a esse estado de caixa de diálogo.

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

O estado de uma caixa de diálogo pode incluir fatores como a última pasta visitada e a posição e o tamanho da caixa de diálogo.

Normalmente, esse estado é persistente com base no nome do arquivo executável. Ao especificar um GUID, um aplicativo pode ter diferentes estados persistentes para diferentes versões da caixa de diálogo dentro do mesmo aplicativo (por exemplo, uma caixa de diálogo de importação e uma caixa de diálogo aberta).

IFileDialog::SetClientGuid deve ser chamado imediatamente após a criação do objeto de caixa de diálogo.

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)