Partager via

RegisterAppInstance, fonction (smbclnt.h)

Inscrit l’ID AppInstance pour un processus.

Syntaxe

DWORD RegisterAppInstance(
  [in] HANDLE ProcessHandle,
  [in] GUID   *AppInstanceId,
  [in] BOOL   ChildrenInheritAppInstance
);

Paramètres

[in] ProcessHandle

Handle de processus pour le processus actuel ou un processus distant à marquer avec l'AppInstanceId. Pour baliser un processus distant, le handle doit avoir PROCESS_TERMINATE accès à ce processus.

[in] AppInstanceId

ID d’instance d’application, qui est un GUID .

[in] ChildrenInheritAppInstance

TRUE pour étiqueter les processus enfants générés par le processus spécifié par ProcessHandle; sinon, FALSE.

Valeur de retour

Retourner le code Description
ERROR_NOT_ENOUGH_MEMORY
 Le filtre CCF n’a pas pu allouer les objets de cache appropriés pour effectuer cette opération.
ERROR_ACCESS_DENIED
 Le processus actuel qui tente d’étiqueter le processus spécifié par ProcessHandle n’a pas PROCESS_TERMINATE accès à ce processus.
ERROR_INVALID_PARAMETER
 ProcessHandle n’est pas un handle pour un processus.
ERROR_NOT_FOUND
 Le mini-filtre CCF est introuvable.
ERROR_OBJECT_ALREADY_EXISTS
 Une autre AppInstanceGUID est fournie pour le même processus, ce qui signifie que la fonction RegisterAppInstance a été appelée deux fois ou que l’application a été inscrite deux fois.

Remarques

La fonction RegisterAppInstance émet un appel IOCTL_CCF_REGISTER_APPINSTANCE au mini-filtre CCF. La fonction transmet l'AppInstanceGUID, le handle de processus et les processus enfants étiquetés au cache CCF qui mappe le handle de processus auAppInstanceId .

Le IOCTL émis pour l’étiquetage d’un autre processus vérifie si le processus actuel a PROCESS_TERMINATE accès au processus cible.

Exigences

Exigence Valeur
client minimum pris en charge Aucun pris en charge
serveur minimum pris en charge Windows Server 2012
plateforme cible Windows
d’en-tête smbclnt.h
bibliothèque NTLanMan.lib
DLL NTLanMan.dll

Voir aussi

fonctions de gestion des ressources de cluster de basculement

  • Last updated on