Compartilhar via

Função RmRegisterResources (restartmanager.h)

Registra recursos em uma sessão do Gerenciador de Reinicialização. O Gerenciador de Reinicialização usa a lista de recursos registrados com a sessão para determinar quais aplicativos e serviços devem ser desligados e reiniciados. Os recursos podem ser identificados por nomes de arquivo, nomes curtos de serviço ou estruturas de RM_UNIQUE_PROCESS que descrevem aplicativos em execução. A função RmRegisterResources pode ser usada por um instalador primário ou secundário.

Sintaxe

DWORD RmRegisterResources(
  [in]           DWORD                dwSessionHandle,
  [in]           UINT                 nFiles,
  [in, optional] LPCWSTR []           rgsFileNames,
  [in]           UINT                 nApplications,
  [in, optional] RM_UNIQUE_PROCESS [] rgApplications,
  [in]           UINT                 nServices,
  [in, optional] LPCWSTR []           rgsServiceNames
);

Parâmetros

[in] dwSessionHandle

Um identificador para uma sessão existente do Gerenciador de Reinicialização.

[in] nFiles

O número de arquivos que estão sendo registrados.

[in, optional] rgsFileNames

Uma matriz de cadeias de caracteres terminadas em nulo de caminhos de nome de arquivo completos. Esse parâmetro poderá ser NULL se nFiles for 0.

[in] nApplications

O número de processos sendo registrados.

[in, optional] rgApplications

Uma matriz de estruturas RM_UNIQUE_PROCESS . Esse parâmetro poderá ser NULL se nApplications for 0.

[in] nServices

O número de serviços a serem registrados.

[in, optional] rgsServiceNames

Uma matriz de cadeias de caracteres terminadas em nulo de nomes curtos de serviço. Esse parâmetro poderá ser NULL se nServices for 0.

Retornar valor

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
 Os recursos especificados foram registrados.
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.

Comentários

Cada chamada para a função RmRegisterResources executa operações de gravação relativamente caras. Não chame essa função uma vez por arquivo, em vez disso, agrupe arquivos relacionados em componentes e registre-os juntos.

Requisitos

Requisito Valor
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
  • Last updated on