função CM_WaitNoPendingInstallEvents (cfgmgr32.h)
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 |
|---|---|
|
Não há atividades de instalação pendentes. |
|
O intervalo de tempo limite decorrido e as atividades de instalação ainda estão pendentes. |
|
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 |