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) |