Partager via

<legacyImpersonationPolicy>, élément

  • Article

Mise à jour : novembre 2007

Spécifie que l'identité Windows n'est pas transmise entre des points asynchrones, quels que soient les paramètres de flux du contexte d'exécution sur le thread actif.

<configuration>, élément
  <runtime>, élément
    <legacyImpersonationPolicy>, élément

<legacyImpersonationPolicy  
   enabled="true|false"/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

enabled

Attribut requis.

Spécifie que WindowsIdentity n'est pas transmis entre des points asynchrones, quels que soient les paramètres de flux de ExecutionContext sur le thread actif.

Attribut activé

Valeur

Description

false

WindowsIdentity est transmis entre des points asynchrones en fonction des paramètres de flux de ExecutionContext pour le thread actif. Il s'agit de l'option par défaut.

true

WindowsIdentity n'est pas transmis entre des points asynchrones, quels que soient les paramètres de flux de ExecutionContext sur le thread actif.

Éléments enfants

Aucun.

Éléments parents

Élément

Description

configuration

Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

runtime

Contient des informations sur les liaisons d'assembly et l'opération garbage collection.

Notes

Dans les versions 1.0 et 1.1 du .NET Framework, WindowsIdentity n'est pas transmis entre des points asynchrones définis par l'utilisateur. Le .NET Framework version 2.0 comprend un objet ExecutionContext qui contient des informations à propos du thread en cours d'exécution et les transmet entre des points asynchrones d'un domaine d'application. WindowsIdentity est également passé dans le cadre du flux d'informations entre les points asynchrones. En d'autres termes, s'il existe un contexte d'emprunt d'identité, il fera également partie du flux transmis. Cet élément permet d'empêcher la transmission de WindowsIdentity entre des points asynchrones.

Remarque :

Le Common Language Runtime (CLR) est informé des opérations d'emprunt d'identité exécutées à l'aide de code managé uniquement, et non des emprunts d'identité exécutés en dehors du code managé, par exemple via un appel de plateforme au code non managé ou via des appels directs aux fonctions Win32. Seuls les objets WindowsIdentity managés peuvent être transmis entre des points asynchrones, sauf si l'élément alwaysFlowImpersonationPolicy a la valeur true (<alwaysFlowImpersonationPolicy enabled="true"/>). La définition de l'élément alwaysFlowImpersonationPolicy sur la valeur true spécifie que l'identité Windows est toujours transmise entre des points asynchrones, indépendamment du mode d'exécution de l'emprunt d'identité. Pour plus d'informations sur la transmission d'un emprunt d'identité non managé entre des points asynchrones, consultez <alwaysFlowImpersonationPolicy>, élément.

Cet élément peut être utilisé uniquement dans le fichier de configuration de l'application.

Vous pouvez modifier ce comportement par défaut de deux autres façons :

  1. Dans le code managé, thread par thread.

    Vous pouvez supprimer le flux thread par thread en modifiant les paramètres ExecutionContext et SecurityContext à l'aide de la méthode ExecutionContext.SuppressFlow, SecurityContext.SuppressFlowWindowsIdentity ou SecurityContext.SuppressFlow.

  2. Dans l'appel à l'interface d'hébergement non managée pour charger le Common Language Runtime.

    Si vous utilisez une interface d'hébergement non managée (au lieu d'un simple fichier exécutable managé) pour charger le Common Language Runtime, vous pouvez spécifier un indicateur spécial dans l'appel à la fonction CorBindToRuntimeEx, fonction. Pour activer le mode de compatibilité pour l'ensemble du processus, affectez la valeur STARTUP_LEGACY_IMPERSONATION au paramètre flags de CorBindToRuntimeEx, fonction.

Exemple

L'exemple suivant montre comment spécifier le comportement hérité (legacy) qui ne transmet pas l'identité Windows entre des points asynchrones.

<configuration>
   <runtime>
      <legacyImpersonationPolicy enabled="true"/>
   </runtime>
</configuration>

Voir aussi

Référence

Schéma des paramètres d'exécution

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework