função CM_WaitNoPendingInstallEvents (cfgmgr32.h)

  • Artigo

A função CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) aguarda até que não haja atividades pendentes de instalação do dispositivo para o gerenciador PnP executar.

Sintaxe

DWORD CM_WaitNoPendingInstallEvents(
  [in] DWORD dwTimeout
);

Parâmetros

[in] dwTimeout

Especifica um intervalo de tempo limite, em milissegundos.

  • Se dwTimeout estiver definido como zero, a função testará se há eventos de instalação pendentes e retornará imediatamente.
  • Se dwTimeout estiver definido como INFINITE (definido em Winbase.h), o intervalo de tempo limite da função nunca será decorrido.
  • Para todos os outros valores dwTimeout , a função retorna quando o intervalo especificado decorrido, mesmo que ainda haja eventos de instalação pendentes.

Retornar valor

A função retorna um dos seguintes valores (definidos em Winbase.h):

Código de retorno Descrição
WAIT_OBJECT_0
 Não há atividades de instalação pendentes.
WAIT_TIMEOUT
 O intervalo de tempo limite decorrido e as atividades de instalação ainda estão pendentes.
WAIT_FAILED
 Falha na função. Chame GetLastError para obter informações adicionais de erro.

Comentários

A função aguarda um objeto de evento interno, que o gerenciador PnP define quando determina que nenhuma atividade de instalação está pendente.

Se um valor de tempo limite diferente de zero for especificado, CMP_WaitNoPendingInstallEvents retornará quando nenhum evento de instalação estiver pendente ou quando o período de tempo limite expirar, o que ocorrer primeiro.

Novos eventos de instalação podem ocorrer a qualquer momento. Essa função apenas indica que não há atividades de instalação pendentes no momento em que ela é chamada.

Normalmente, essa função é usada por aplicativos de instalação de dispositivo. Para obter mais informações, consulte Escrevendo um aplicativo de instalação de dispositivo.

Não chame essa função durante o processamento de eventos dentro de uma função de retorno de chamada iniciada pelo sistema que deverá retornar em um curto período de tempo. Isso inclui a inicialização do serviço (por exemplo, na função de retorno de chamada ServiceMain ) ou durante o processamento de qualquer controle no manipulador de serviço (por exemplo, a função de retorno de chamada manipulador ) ou de componentes de instalação, como instaladores de classe ou co-instaladores.

Para o Windows XP (sem nenhum service pack instalado), essa função deve ser chamada da sessão zero, com privilégios de administrador. Para o Windows XP com Service Pack 1 (SP1) e versões posteriores do Windows, a função pode ser chamada de qualquer sessão e privilégios de administrador não são necessários.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_WaitNoPendingInstallEvents

Como um aplicativo de instalação de dispositivo verifica se há instalações de dispositivo em andamento