User.IsUserMemberOf - Méthode

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

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Syntaxe

'Déclaration
Function IsUserMemberOf ( _
    bstrGroupname As String _
) As Boolean
'Utilisation
Dim instance As User
Dim bstrGroupname As String
Dim returnValue As Boolean

returnValue = instance.IsUserMemberOf(bstrGroupname)

bool IsUserMemberOf(
    string bstrGroupname
)

Paramètres

• bstrGroupname
  Type : System.String

  Nom de groupe au format « domaine\nomgroupe ».

Valeur renvoyée

Type : System.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.

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 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 du code non approuvé d'un modèle de formulaire InfoPath, dont l'URL est par exemple « https://www.contoso.com/exemple.xsn », l'appel émane 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/exemple.xsn », l'appel émane 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é.

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 « DomaineGroupe\Administrateurs ».

bool groupMatched;
groupMatched = thisApplication.User.IsUserMemberOf(@"GroupDomain\Administrators");

Voir aussi

Référence

User interface

User - Membres

Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms