Função RmGetList (restartmanager.h)

  • Artigo

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
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 buffer rgAffectedApps 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 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.
ERROR_WRITE_FAULT
29
 Uma operação não pôde ler ou gravar no registro.
ERROR_OUTOFMEMORY
14
 Uma operação do Gerenciador de Reinicialização 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.

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

RmCancelCurrentTask