Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Registriert die AppInstance--ID für einen Prozess.
Syntax
DWORD RegisterAppInstance(
[in] HANDLE ProcessHandle,
[in] GUID *AppInstanceId,
[in] BOOL ChildrenInheritAppInstance
);
Parameter
[in] ProcessHandle
Ein Prozesshandle für den aktuellen Prozess oder einen Remoteprozess, der mit der AppInstanceId-markiert werden soll. Um einen Remoteprozess zu markieren, muss der Handle über PROCESS_TERMINATE Zugriff auf diesen Prozess verfügen.
[in] AppInstanceId
Die Anwendungsinstanz-ID, bei der es sich um eine GUIDhandelt.
[in] ChildrenInheritAppInstance
TRUE-, um die untergeordneten Prozesse zu markieren, die vom durch ProcessHandle-angegebenen Prozess erstellt wurden; andernfalls FALSE.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
|
Der CCF-Filter konnte die richtigen Cacheobjekte nicht zuordnen, um diesen Vorgang zu erfüllen. |
|
Der aktuelle Prozess, der versucht, den durch ProcessHandle- angegebenen Prozess zu kategorisieren, hat keinen PROCESS_TERMINATE Zugriff auf diesen Prozess. |
|
ProcessHandle- kein Handle für einen Prozess ist. |
|
Der CCF-Minifilter wurde nicht gefunden. |
|
Ein weiteres AppInstanceGUID- wird für denselben Prozess bereitgestellt, was bedeutet, dass die RegisterAppInstance Funktion zweimal aufgerufen wurde oder die Anwendung zweimal registriert wurde. |
Bemerkungen
Die RegisterAppInstance-Funktion gibt einen IOCTL_CCF_REGISTER_APPINSTANCE Aufruf des CCF-Minifilters aus. Die Funktion übergibt die AppInstanceGUID-, das Prozesshandle und die markierten untergeordneten Prozesse an den CCF-Cache, der das Prozesshandle dem AppInstanceId-zuordnet.
Die ausgestellte IOCTL zum Kategorisieren eines weiteren Prozesses prüft, ob der aktuelle Prozess PROCESS_TERMINATE Zugriff auf den Zielprozess hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Keine unterstützt |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Fenster |
| Header- | smbclnt.h |
| Library | NTLanMan.lib |
| DLL- | NTLanMan.dll |