Compartilhar via

Função RmRemoveFilter (restartmanager.h)

  • Artigo

Remove as modificações nas ações de desligamento ou reinicialização que foram aplicadas usando a função RmAddFilter . O instalador primário pode chamar a função RmRemoveFilter várias vezes.

Sintaxe

DWORD RmRemoveFilter(
  [in]           DWORD             dwSessionHandle,
  [in, optional] LPCWSTR           strModuleName,
  [in, optional] RM_UNIQUE_PROCESS *pProcess,
  [in, optional] LPCWSTR           strServiceShortName
);

Parâmetros

[in] dwSessionHandle

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

[in, optional] strModuleName

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o caminho completo para o arquivo executável do aplicativo. A função RmRemoveFilter remove todas as modificações nas ações de desligamento ou reinicialização do aplicativo referenciadas anteriormente aplicadas pela função RmAddFilter . Esse parâmetro deverá ser NULL se o parâmetro Application ou strServiceShortName não for NULL.

[in, optional] pProcess

A estrutura RM_UNIQUE_PROCESS para o aplicativo. A função RmRemoveFilter remove todas as modificações nas ações de desligamento ou reinicialização do aplicativo referenciadas anteriormente aplicadas pela função RmAddFilter . Esse parâmetro deverá ser NULL se o parâmetro strFilename ou strShortServiceName não for NULL.

[in, optional] strServiceShortName

Um ponteiro para um valor de cadeia de caracteres terminada em nulo que contém o nome do serviço curto. A função RmRemoveFilter remove todas as modificações nas ações de desligamento ou reinicialização do serviço referenciado aplicadas anteriormente pela função RmAddFilter . Esse parâmetro deverá ser NULL se o parâmetro strFilename ou Application não for NULL.

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
 A função foi concluída com êxito.
ERROR_FILE_NOT_FOUND
1
 Não foi possível encontrar o filtro especificado.
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
 Esse erro é retornado quando um instalador secundário chama essa função. Essa função só está disponível para instaladores primários.

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