RmAddFilter-Funktion (restartmanager.h)

Artikel
08/25/2023

Ändert die Aktionen zum Herunterfahren oder Neustarten, die auf eine Anwendung oder einen Dienst angewendet werden. Das primäre Installationsprogramm kann die RmAddFilter-Funktion mehrmals aufrufen. Mit dem letzten Aufruf werden alle vorherigen Änderungen an derselben Datei, demselben Prozess oder demselben Dienst außer Kraft gesetzt.

Syntax

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

Parameter

[in] dwSessionHandle

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

[in, optional] strModuleName

Ein Zeiger auf einen null-beendeten Zeichenfolgenwert, der den vollständigen Pfad zur ausführbaren Datei der Anwendung enthält. Änderungen an Aktionen zum Herunterfahren oder Neustart werden für die Anwendung angewendet, auf die der vollständige Pfad verweist. Dieser Parameter muss NULL sein, wenn der Application - oder strServiceShortName-Parameter nicht NULL ist.

[in, optional] pProcess

Ein Zeiger auf eine RM_UNIQUE_PROCESS Struktur für die Anwendung. Änderungen an Herunterfahren- oder Neustartaktionen werden für die Anwendung angewendet, auf die von der RM_UNIQUE_PROCESS-Struktur verwiesen wird. Dieser Parameter muss NULL sein, wenn der strFilename - oder strShortServiceName-Parameter nicht NULL ist.

[in, optional] strServiceShortName

Ein Zeiger auf einen NULL-beendeten Zeichenfolgenwert, der den kurzen Dienstnamen enthält. Änderungen an Herunterfahren- oder Neustartaktionen werden für den Dienst angewendet, auf den durch den kurzen Dienstdateinamen verwiesen wird. Dieser Parameter muss NULL sein, wenn der strFilename - oder Application-Parameter nicht NULL ist.

[in] FilterAction

Ein RM_FILTER_ACTION Enumerationswert, der den Typ der anzuwendenden Änderung angibt.

Rückgabewert

Dies ist der neueste Fehler, der empfangen wurde. 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 Neustart-Manager zurückgegeben, wenn ein NULL-Zeiger oder 0 als Parameter übergeben wird, der einen Ungleich-NULL- und ungleich null-Wert erfordert.
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.

Anforderungen


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

RmGetFilterList

Freigeben über