Método IVsCommonMessagePump.ModalWaitForObjects (IntPtr , UInt32, UInt32)

Artigo
04/23/2016

Use esse método para aguardar a objetos sinalizar (provavelmente por algum processamento em segundo plano), mantendo o VS responsivo.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.10.0 (em Microsoft.VisualStudio.Shell.Interop.10.0.dll)

Sintaxe

int ModalWaitForObjects(
    IntPtr[] rgHandles,
    uint cHandles,
    out uint pdwWaitResult
)

int ModalWaitForObjects(
    array<IntPtr>^ rgHandles,
    unsigned int cHandles,
    [OutAttribute] unsigned int% pdwWaitResult
)

abstract ModalWaitForObjects : 
        rgHandles:nativeint[] *
        cHandles:uint32 *
        pdwWaitResult:uint32 byref -> int

Function ModalWaitForObjects (
    rgHandles As IntPtr(),
    cHandles As UInteger,
    <OutAttribute> ByRef pdwWaitResult As UInteger
) As Integer

Parâmetros

rgHandles
A matriz que contém as alças dos objetos para aguardar.

cHandles
O número de identificadores na matriz.O máximo é 64.

pdwWaitResult
[out] O resultado que é definido quando a condição de espera foi atendida (isto é, quando o método retornou T:Microsoft.VisualStudio.VSConstants.S_OK):
1. WAIT_OBJECT_0 para (WAIT_OBJECT_0 + cHandles - 1) indica o objeto signaled (aplica-se somente quando fWaitForAllObjects é false).
2. WAIT_OBJECT_0 se fWaitForAllObjects foi true.
3. WAIT_TIMEOUT o intervalo de tempo limite decorrido antes da condição especificada por fWaitForAllObjects foi atendido.

Valor de retorno

Type: System.Int32

S_OKSe a condição de espera foi atendida; the pdwWaitResultparâmetro irá conter mais informações sobre o resultado de espera.Retorna E_PENDING se o método teve que sair porque o usuário cancelou a operação de esperar.E_ABORTSe WM_QUIT foi recebida.

Comentários

Este é o método preferido para usar nessa interface.Ele não exige o consumidor implementar qualquer coisa.O método coloca automaticamente o IDE em um estado de janela restrito, que reduz o risco da reentrância.Exibe o método também lida com o padrão da interface do usuário que explica o motivo para a espera.Essa espera UI é mostrada aproximadamente 2 segundos após o tempo de espera foi iniciado.

Consulte também

Interface IVsCommonMessagePump
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via