RmGetFilterList-Funktion (restartmanager.h)

Artikel
03/01/2024

Listen die Änderungen an Aktionen zum Herunterfahren und Neustarten, die bereits von der RmAddFilter-Funktion angewendet wurden. Die Funktion gibt einen Zeiger auf einen Puffer zurück, der Informationen zu den angewendeten Änderungen enthält.

Syntax

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

Parameter

[in] dwSessionHandle

Ein Handle für eine vorhandene Restart Manager-Sitzung.

[out, optional] pbFilterBuf

Ein Zeiger auf einen Puffer, der Änderungsinformationen enthält.

[in] cbFilterBuf

Die Größe des Puffers, der Änderungsinformationen in Bytes enthält.

[out] cbFilterBufNeeded

Die Anzahl der im Puffer benötigten Bytes.

Rückgabewert

Dies ist der letzte empfangene Fehler. Die Funktion kann einen der Systemfehlercodes zurückgeben, die in Winerror.h definiert sind.

Wert	Bedeutung
ERROR_SUCCESS 0	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_BAD_ARGUMENTS 160	Mindestens ein Argument ist falsch. Dieser Fehlerwert wird von der Funktion Restart Manager zurückgegeben, wenn ein NULL-Zeiger oder 0 als Parameter übergeben wird, der einen Wert ungleich NULL und ungleich 0 erfordert.
ERROR_MORE_DATA 234	Dieser Fehlerwert wird von der RmGetFilterList-Funktion zurückgegeben, wenn der pbFilterBuf-Puffer zu klein ist, um alle Anwendungsinformationen in der Liste zu speichern, oder wenn cbFilterBufNeeded nicht angegeben wurde.
ERROR_SESSION_CREDENTIAL_CONFLICT 1219	Dieser Fehler wird zurückgegeben, wenn ein sekundäres Installationsprogramm diese Funktion aufruft. Diese Funktion ist nur für primäre Installationsprogramme verfügbar.

Hinweise

Der zurückgegebene pbFilterBuf-Puffer muss typecast sein, um RM_FILTER_INFO auf die Filterliste zuzugreifen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	restartmanager.h
Bibliothek	Rstrtmgr.lib
DLL	Rstrtmgr.dll

Weitere Informationen

RmAddFilter

Freigeben über