Função RmGetList (restartmanager.h)
Obtém uma lista de todos os aplicativos e serviços que estão usando recursos que foram registrados na sessão do Gerenciador de Reinicialização.
Sintaxe
DWORD RmGetList(
[in] DWORD dwSessionHandle,
[out] UINT *pnProcInfoNeeded,
[in, out] UINT *pnProcInfo,
[in, out, optional] RM_PROCESS_INFO [] rgAffectedApps,
[out] LPDWORD lpdwRebootReasons
);
Parâmetros
[in] dwSessionHandle
Um identificador para uma sessão existente do Gerenciador de Reinicialização.
[out] pnProcInfoNeeded
Um ponteiro para um tamanho de matriz necessário para receber RM_PROCESS_INFO estruturas necessárias para retornar informações para todos os aplicativos e serviços afetados.
[in, out] pnProcInfo
Um ponteiro para o número total de estruturas RM_PROCESS_INFO em uma matriz e número de estruturas preenchidas.
[in, out, optional] rgAffectedApps
Uma matriz de estruturas RM_PROCESS_INFO que listam os aplicativos e serviços usando recursos que foram registrados na sessão.
[out] lpdwRebootReasons
Ponteiro para o local que recebe um valor da enumeração RM_REBOOT_REASON que descreve o motivo pelo qual uma reinicialização do sistema é necessária.
Valor retornado
Esse é o erro mais recente recebido. A função pode retornar um dos códigos de erro do sistema definidos em Winerror.h.
Valor | Significado |
---|---|
|
A função foi concluída com êxito. |
|
Esse valor de erro será retornado pela função RmGetList se o buffer rgAffectedApps for muito pequeno para conter todas as informações do aplicativo na lista. |
|
A operação atual é cancelada pelo usuário. |
|
Uma função do Gerenciador de Reinicialização não pôde obter um mutex de gravação do Registro no tempo alocado. Uma reinicialização do sistema é recomendada porque o uso adicional do Gerenciador de Reinicialização provavelmente falhará. |
|
Um ou mais argumentos não estão corretos. Esse valor de erro será retornado pela função Gerenciador de Reinicialização se um ponteiro NULL ou 0 for passado em um parâmetro que requer um valor não nulo e diferente de zero. |
|
Uma operação não pôde ler ou gravar no registro. |
|
Uma operação do Gerenciador de Reinicialização não pôde ser concluída porque não havia memória suficiente disponível. |
|
Não existe nenhuma sessão do Gerenciador de Reinicialização para o identificador fornecido. |
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 | restartmanager.h |
Biblioteca | Rstrtmgr.lib |
DLL | Rstrtmgr.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de