Compartir a través de

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

  • Artículo

Permite que una aplicación de llamada asocie un GUID con el estado persistente de un cuadro de diálogo.

Sintaxis

HRESULT SetClientGuid(
  [in] REFGUID guid
);

Parámetros

[in] guid

Tipo: REFGUID

GUID que se va a asociar a este estado de diálogo.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El estado de un cuadro de diálogo puede incluir factores como la última carpeta visitada y la posición y el tamaño del cuadro de diálogo.

Normalmente, este estado se mantiene en función del nombre del archivo ejecutable. Al especificar un GUID, una aplicación puede tener distintos estados persistentes para las distintas versiones del cuadro de diálogo dentro de la misma aplicación (por ejemplo, un cuadro de diálogo de importación y un cuadro de diálogo abierto).

Se debe llamar a IFileDialog::SetClientGuid inmediatamente después de la creación del objeto de diálogo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)