RmRemoveFilter-Funktion (restartmanager.h)

  • Artikel

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.

Wert Bedeutung
ERROR_SUCCESS
0
 Die Funktion wurde erfolgreich abgeschlossen.
ERROR_FILE_NOT_FOUND
1
 Der angegebene Filter konnte nicht gefunden werden.
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

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