RmRemoveFilter-Funktion (restartmanager.h)

Entfernt alle Änderungen am Herunterfahren oder Neustarten von Aktionen, die mithilfe der RmAddFilter-Funktion angewendet wurden. Das primäre Installationsprogramm kann die RmRemoveFilter-Funktion mehrmals aufrufen.

Syntax

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

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 für die ausführbare Datei der Anwendung enthält. Die RmRemoveFilter-Funktion entfernt alle Änderungen an den Aktionen zum Herunterfahren oder Neustarten der Anwendung, auf die verwiesen wird, die zuvor von der RmAddFilter-Funktion angewendet wurden. Dieser Parameter muss NULL sein, wenn der Application - oder strServiceShortName-Parameter nicht NULL ist.

[in, optional] pProcess

Die RM_UNIQUE_PROCESS Struktur für die Anwendung. Die RmRemoveFilter-Funktion entfernt alle Änderungen an den Aktionen zum Herunterfahren oder Neustarten der Anwendung, auf die verwiesen wird, die zuvor von der RmAddFilter-Funktion angewendet wurden. 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. Die RmRemoveFilter-Funktion entfernt alle Änderungen an den Aktionen zum Herunterfahren oder Neustarten des Diensts, auf die verwiesen wird, die zuvor von der RmAddFilter-Funktion angewendet wurden. Dieser Parameter muss NULL sein, wenn der strFilename - oder Application-Parameter nicht NULL ist.

Rückgabewert

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

Anforderungen