Compartilhar via

Função RmGetFilterList (restartmanager.h)

  • Artigo

Listas as modificações nas ações de desligamento e reinicialização que já foram aplicadas pela função RmAddFilter. A função retorna um ponteiro para um buffer que contém informações sobre as modificações que foram aplicadas.

Sintaxe

DWORD RmGetFilterList(
  [in]            DWORD   dwSessionHandle,
  [out, optional] PBYTE   pbFilterBuf,
  [in]            DWORD   cbFilterBuf,
  [out]           LPDWORD cbFilterBufNeeded
);

Parâmetros

[in] dwSessionHandle

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

[out, optional] pbFilterBuf

Um ponteiro para um buffer que contém informações de modificação.

[in] cbFilterBuf

O tamanho do buffer que contém informações de modificação em bytes.

[out] cbFilterBufNeeded

O número de bytes necessários no buffer.

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_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 como um parâmetro que requer um valor não nulo e diferente de zero.
ERROR_MORE_DATA
234
 Esse valor de erro será retornado pela função RmGetFilterList se o buffer pbFilterBuf for muito pequeno para manter todas as informações do aplicativo na lista ou se cbFilterBufNeeded não tiver sido 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.

Comentários

O buffer pbFilterBuf retornado deve ser tipado para RM_FILTER_INFO para acessar a lista de filtros.

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

Confira também

RmAddFilter