Método IProgressDialog::SetCancelMsg (shlobj_core.h)

Establece un mensaje que se mostrará si el usuario cancela la operación.

Sintaxis

HRESULT SetCancelMsg(
  [in] PCWSTR  pwzCancelMsg,
       LPCVOID pvResevered
);

Parámetros

[in] pwzCancelMsg

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que contiene el mensaje que se va a mostrar.

pvResevered

Tipo: LPCVOID

Reservado. Se establece en NULL.

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

Aunque el usuario hace clic en Cancelar, la aplicación no puede llamar inmediatamente a IProgressDialog::StopProgressDialog para cerrar el cuadro de diálogo. La aplicación debe esperar hasta la próxima vez que llame a IProgressDialog::HasUserCancelled para detectar que el usuario ha cancelado la operación. Dado que este retraso puede ser significativo, el cuadro de diálogo de progreso proporciona al usuario comentarios inmediatos borrando las líneas de texto 1 y 2 y mostrando el mensaje de cancelación en la línea 3. El mensaje está pensado para informar al usuario de que el retraso es normal y que el cuadro de diálogo de progreso se cerrará en breve. Normalmente, se establece en algo parecido a "Espere mientras...".

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

IProgressDialog