User2.IsUserMemberOf - Méthode (String)
Renvoie une valeur qui indique si l'utilisateur actuel est membre du groupe spécifié.
Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)
Syntaxe
'Déclaration
Function IsUserMemberOf ( _
bstrGroupname As String _
) As Boolean
'Utilisation
Dim instance As User2
Dim bstrGroupname As String
Dim returnValue As Boolean
returnValue = instance.IsUserMemberOf(bstrGroupname)
bool IsUserMemberOf(
string bstrGroupname
)
Paramètres
bstrGroupname
Type : System.StringNom 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.
Implémentations
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é.
Notes
Les informations d'appartenance à un groupe sont entièrement publiques si elles sont accessibles et 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.
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");