Método IIOCancelInformation::SetCancelInformation (shobjidl_core.h)

Define informações que são postadas quando um usuário seleciona Cancelar na interface do usuário de progresso. Permite que o objeto main informe o thread da caixa de diálogo de progresso sobre o thread do processo para que a caixa de diálogo de progresso possa enviar ao thread do processo a ID da mensagem quando o usuário clicar em Cancelar.

Sintaxe

HRESULT SetCancelInformation(
  [in] DWORD dwThreadID,
  [in] UINT  uMsgCancel
);

Parâmetros

[in] dwThreadID

Tipo: DWORD

A ID do thread de processo a ser cancelado.

[in] uMsgCancel

Tipo: UINT

A mensagem de cancelamento a ser postada no thread.

Valor retornado

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

Quando o usuário seleciona Cancelar da interface do usuário de progresso, o dwThreadID cancelará todas as solicitações de E/S (entrada/saída) pendentes ou futuras. Além disso, a mensagem uMsgCancel , recebida da caixa de diálogo de progresso, será postada no thread para dizer a ele para sair de um estado de espera, se a E/S assíncrona estiver pendente.

Requisitos

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)
DLL	Shell32.dll