Funzione RmGetFilterList (restartmanager.h)

Articolo
03/01/2024

Elenchi le modifiche apportate all'arresto e al riavvio delle azioni già applicate dalla funzione RmAddFilter. La funzione restituisce un puntatore a un buffer contenente informazioni sulle modifiche applicate.

Sintassi

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

Parametri

[in] dwSessionHandle

Handle per una sessione di Gestione riavvio esistente.

[out, optional] pbFilterBuf

Puntatore a un buffer che contiene informazioni di modifica.

[in] cbFilterBuf

Dimensioni del buffer che contiene informazioni di modifica in byte.

[out] cbFilterBufNeeded

Numero di byte necessari nel buffer.

Valore restituito

Si tratta dell'errore più recente ricevuto. La funzione può restituire uno dei codici di errore di sistema definiti in Winerror.h.

Valore	Significato
ERROR_SUCCESS 0	La funzione è stata completata correttamente.
ERROR_BAD_ARGUMENTS 160	Uno o più argomenti non sono corretti. Questo valore di errore viene restituito dalla funzione Restart Manager se un puntatore NULL o 0 viene passato come parametro che richiede un valore diverso da null e non zero.
ERROR_MORE_DATA 234	Questo valore di errore viene restituito dalla funzione RmGetFilterList se il buffer pbFilterBuf è troppo piccolo per contenere tutte le informazioni dell'applicazione nell'elenco o se cbFilterBufNeeded non è stato specificato.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Questo errore viene restituito quando un programma di installazione secondario chiama questa funzione. Questa funzione è disponibile solo per i programmi di installazione primari.

Commenti

Il buffer pbFilterBuf restituito deve essere typecast per RM_FILTER_INFO per accedere all'elenco di filtri.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	restartmanager.h
Libreria	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Vedi anche

RmAddFilter

Condividi tramite