User.IsUserMemberOf(String) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Renvoie une valeur qui indique si l'utilisateur actuel est membre du groupe spécifié.

public:
 bool IsUserMemberOf(System::String ^ bstrGroupname);

public bool IsUserMemberOf (string bstrGroupname);

abstract member IsUserMemberOf : string -> bool

Public Function IsUserMemberOf (bstrGroupname As String) As Boolean

Paramètres

bstrGroupname

String

Nom de groupe au format « domaine\nomgroupe ».

Retours

Boolean

La valeur true est renvoyée si l'utilisateur actuel est membre du groupe spécifié. Dans le cas contraire, c'est la valeur false qui est renvoyée.

Exemples

Dans l’exemple suivant, la méthode IsUserMemberOf de l’objet UserObject est utilisée pour déterminer si l’utilisateur actuel est membre du groupe « GroupDomain\Administrators ».

bool groupMatched;
groupMatched = thisApplication.User.<span class="label">IsUserMemberOf</span>(@"GroupDomain\Administrators");

Remarques

Même si le niveau de sécurité 0 est affecté à la méthode IsUserMemberOf, celle-ci n'est pas toujours accessible. Lors d'un appel à la méthode IsUserMemberOf, InfoPath effectue au préalable une vérification de la sécurité pour déterminer si l'accès à cette méthode est autorisé. Cette vérification de la sécurité permet de confirmer la fiabilité du code appelant et de déterminer son emplacement.

Si le code appelant est fiable (comme c'est le cas par exemple lorsque la méthode IsUserMemberOf est appelée à partir d'un modèle de formulaire InfoPath installé ou signé ou à partir d'un code externe fiable, par exemple un fichier exécutable situé sur l'ordinateur local), InfoPath autorise l'accès complet à la méthode IsUserMemberOf.

Si le code appelant n'est pas fiable (comme c'est le cas lorsqu'un appel émane d'un modèle de formulaire InfoPath basé sur un domaine ou d'un script s'exécutant dans Microsoft Internet Explorer), InfoPath vérifie au préalable l'origine de l'appel. Si l’appel provient d’un code qui n’est pas approuvé dans un modèle de formulaire InfoPath à une URL telle que «http://www.contoso.com/example.xsn », l’appel provient de la zone Internet. InfoPath refuse l'accès à la méthode IsUserMemberOf pour tous les appels non approuvés émanant de la zone Internet. Si l’appel provient d’une URL telle que «http://contoso/example.xsn », l’appel provient de la zone Intranet. Lorsqu'un appel non approuvé émane de la zone intranet, InfoPath vérifie si les paramètres d'authentification de l'utilisateur d'Internet Explorer autorisent l'ouverture de session automatique (dans la zone intranet uniquement ou pour toutes les ouvertures de session). Si Internet Explorer est configuré pour une ouverture de session automatique, InfoPath vérifie l'appartenance de l'utilisateur au groupe. Si cette appartenance au groupe est publique, InfoPath autorise l'accès complet à la méthode IsUserMemberOf. Si l'appartenance au groupe n'est pas entièrement publique, InfoPath masque le résultat. En d'autres termes, InfoPath traite l'appartenance à un groupe comme si elle n'était pas visible. Dans ce cas, la valeur de retour est toujours False, car l'appartenance à un groupe n'est pas publique. InfoPath ne signale pas que l'accès est refusé.

Remarque : les informations d’appartenance au groupe sont entièrement publiques si l’accès à ces informations est autorisé et qu’elles sont visibles par tous les utilisateurs non anonymes. Si un seul utilisateur non anonyme se voit refuser l'accès aux informations d'appartenance à un groupe, ces informations ne sont pas considérées comme entièrement publiques.

Important : ce membre est accessible sans restrictions.