RM_PROCESS_INFO-Struktur (restartmanager.h)

Artikel
08/25/2023

Beschreibt eine Anwendung, die beim Neustart-Manager registriert werden soll.

Syntax

typedef struct _RM_PROCESS_INFO {
  RM_UNIQUE_PROCESS Process;
  WCHAR             strAppName[CCH_RM_MAX_APP_NAME + 1];
  WCHAR             strServiceShortName[CCH_RM_MAX_SVC_NAME + 1];
  RM_APP_TYPE       ApplicationType;
  ULONG             AppStatus;
  DWORD             TSSessionId;
  BOOL              bRestartable;
} RM_PROCESS_INFO, *PRM_PROCESS_INFO;

Members

Process

Enthält eine RM_UNIQUE_PROCESS Struktur, die die Anwendung anhand ihrer PID und den Zeitpunkt, zu dem der Prozess gestartet wurde, eindeutig identifiziert.

strAppName[CCH_RM_MAX_APP_NAME + 1]

Wenn der Prozess ein Dienst ist, gibt dieser Parameter den langen Namen für den Dienst zurück. Wenn der Prozess kein Dienst ist, gibt dieser Parameter den benutzerfreundlichen Namen für die Anwendung zurück. Wenn der Prozess ein kritischer Prozess ist und der Installer mit erhöhten Berechtigungen ausgeführt wird, gibt dieser Parameter den Namen der ausführbaren Datei des kritischen Prozesses zurück. Wenn der Prozess ein kritischer Prozess ist und das Installationsprogramm als Dienst ausgeführt wird, gibt dieser Parameter den langen Namen des kritischen Prozesses zurück.

strServiceShortName[CCH_RM_MAX_SVC_NAME + 1]

Wenn es sich bei dem Prozess um einen Dienst handelt, ist dies der Kurzname für den Dienst. Dieser Member wird nicht verwendet, wenn der Prozess kein Dienst ist.

ApplicationType

Enthält einen RM_APP_TYPE Enumerationswert, der den Anwendungstyp als RmUnknownApp, RmMainWindow, RmOtherWindow, RmService, RmExplorer oder RmCritical angibt.

AppStatus

Enthält eine Bitmaske, die die aktuelle status der Anwendung beschreibt. Weitere Informationen finden Sie in der RM_APP_STATUS-Enumeration .

TSSessionId

Enthält die Terminaldienste-Sitzungs-ID des Prozesses. Wenn die Terminalsitzung des Prozesses nicht bestimmt werden kann, wird der Wert dieses Members auf RM_INVALID_SESSION (-1) festgelegt. Dieser Member wird nicht verwendet, wenn es sich bei dem Prozess um einen Dienst oder einen systemkritischen Prozess handelt.

bRestartable

TRUE , wenn die Anwendung vom Neustart-Manager neu gestartet werden kann; andernfalls FALSE. Dieser Member ist immer TRUE , wenn der Prozess ein Dienst ist. Dieser Member ist immer FALSE , wenn es sich um einen kritischen Systemprozess handelt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	restartmanager.h

Weitere Informationen