Share via

RmGetFilterList-Funktion (restartmanager.h)

  • Artikel

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