Função RmGetList (restartmanager.h)

Artigo
11/18/2024

Obtém uma lista de todos os aplicativos e serviços que estão atualmente usando recursos que foram registrados na sessão do Restart Manager.

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 Restart Manager.

[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 de RM_PROCESS_INFO que listam os aplicativos e serviços usando recursos que foram registrados com a 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 de retorno

Este é o erro mais recente recebido. A função pode retornar um dos códigos de erro do sistema definidos em Winerror.h.

Valor	Significado
ERROR_SUCCESS 0	A função foi concluída com êxito.
ERROR_MORE_DATA 234	Esse valor de erro será retornado pela função RmGetList se o rgAffectedApps buffer for muito pequeno para conter todas as informações do aplicativo na lista.
ERROR_CANCELLED 1223	A operação atual é cancelada pelo usuário.
ERROR_SEM_TIMEOUT 121	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á.
ERROR_BAD_ARGUMENTS 160	Um ou mais argumentos não estão corretos. Esse valor de erro será retornado pela função Restart Manager se um ponteiro NULL ou 0 for passado em um parâmetro que requer um valor nulo nãoe não zero.
ERROR_WRITE_FAULT 29	Uma operação não pôde ler ou gravar no Registro.
ERROR_OUTOFMEMORY 14	Uma operação do Restart Manager não pôde ser concluída porque não havia memória suficiente disponível.
ERROR_INVALID_HANDLE 6	Não existe nenhuma sessão do Gerenciador de Reinicialização para o identificador fornecido.
ERROR_ACCESS_DENIED 5	Um caminho registrado para a sessão do Gerenciador de Reinicialização é um diretório.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	restartmanager.h
biblioteca	Rstrtmgr.lib
de DLL	Rstrtmgr.dll

Consulte também

RmCancelCurrentTask

Compartilhar via