SetProcessDynamicEHContinuationTargets, fonction (processthreadsapi.h)

Définit les cibles de continuation de gestion des exceptions dynamiques pour le processus spécifié.

Syntaxe

BOOL SetProcessDynamicEHContinuationTargets(
  HANDLE                                  Process,
  USHORT                                  NumberOfTargets,
  PPROCESS_DYNAMIC_EH_CONTINUATION_TARGET Targets
);

Paramètres

Process

Handle du processus. Ce handle doit disposer du droit d’accès PROCESS_SET_INFORMATION . Pour plus d’informations, consultez Traiter les droits de sécurité et d’accès.

NumberOfTargets

Fournit le nombre de cibles de continuation de gestion des exceptions dynamiques à définir.

Targets

Pointeur vers un tableau de cibles de continuation de gestion des exceptions dynamiques. Pour plus d’informations sur cette structure, consultez PROCESS_DYNAMIC_EH_CONTINUATION_TARGET.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Notez que même si la fonction échoue, une partie des cibles de continuation fournies peut avoir été traitée avec succès. L’appelant doit vérifier les indicateurs dans chaque cible de continuation individuelle spécifiée via Targets pour déterminer s’il a été traité avec succès.

Remarques

Si la protection de pile appliquée par le matériel en mode utilisateur est activée pour un processus, lors de l’appel d’API qui modifient le contexte d’exécution d’un thread tel que RtlRestoreContext et SetThreadContext, la validation est effectuée sur le pointeur d’instruction spécifié dans le nouveau contexte d’exécution. RtlRestoreContext est utilisé pendant le déroulement de l’exception SEH (Structured Exception Handling ) pour décompresser le cadre cible qui contient le bloc et commencer à exécuter du __except code à la cible de continuation. Par conséquent, le système d’exploitation doit connaître les adresses d’instruction de toutes les cibles de continuation valides afin d’autoriser l’opération de déroulement via RtlRestoreContext. Pour les fichiers binaires compilés, la liste des cibles de continuation est générée par l’éditeur de liens et stockée dans l’image binaire. Pour le code dynamique, les cibles de continuation doivent être spécifiées à l’aide de SetProcessDynamicEHContinuationTargets.

Spécifications