Returnerer en boolsk verdi som indikerer om den gjeldende brukeren er medlem av den angitte gruppen.
expression.IsUserMemberOf(ByVal bstrGroupname As String) As Boolean
expression Obligatorisk. Et uttrykk som returnerer en referanse til User-objektet.
bstrGroupname Obligatorisk String. Gruppenavnet, med formatet "domene\gruppenavn".
Sikkerhetsnivå
0: Kan åpnes uten restriksjoner.
Merknader
Selv om IsUserMemberOf-metoden har sikkerhetsnivå 0, er den ikke alltid tilgjengelig. Når et kall gjøres til IsUserMemberOf-metoden, utfører InfoPath først en sikkerhetskontroll for å fastsette om tilgang til denne metoden er tillatt. Sikkerhetskontrollen bekrefter om kallkoden er klarert eller ikke, og fastsetter også plasseringen til kallkoden.
Hvis kallkoden er klarert (som den for eksempel er når IsUserMemberOf-metoden kalles fra en installert eller signert InfoPath-skjemamal eller fra en klarert ekstern kilde, for eksempel en kjørbar fil på den lokale datamaskinen), vil InfoPath tillate fullstendig tilgang til IsUserMemberOf-metoden.
Hvis kallkoden ikke er klarert (for eksempel hvis et kall kommer fra en domenebasert InfoPath-skjemamal eller fra skript som kjører i Microsoft Internet Explorer), kontrollerer InfoPath først hvor kallet kommer fra. Hvis kallet er fra kode som ikke er klarert i en InfoPath-skjemamal på en URL-adresse som for eksempel http://www.contoso.com/eksempel.xsn, er kallet fra Internett-sonen. InfoPath nekter alle ikke-klarerte kall som kommer fra Internett-sonen, tilgang til IsUserMemberOf-metoden. Hvis kallet er fra en URL-adresse som for eksempel http://contoso/eksempel.xsn, er kallet fra intranettsonen. Hvis et ikke-klarert kall kommer fra intranettsonen, kontrollerer InfoPath om innstillingene for brukergodkjenning i Internet Explorer tillater automatisk pålogging (kun i intranettsonen eller for alle pålogginger). Hvis Internet Explorer er konfigurert for automatisk pålogging, kontrollerer InfoPath brukerens gruppemedlemskap. Hvis gruppemedlemskapet er offentlig, tillater InfoPath fullstendig tilgang til IsUserMemberOf-metoden. Hvis gruppemedlemskapet ikke er offentlig, skjuler InfoPath resultatet. Det vil si at InfoPath behandler gruppemedlemskapet som om det ikke var synlig. Returverdien er i dette tilfellet alltid False, fordi gruppemedlemskapet ikke er offentlig. InfoPath rapporterer ikke at tilgang er nektet.
Obs! Informasjon om gruppemedlemskap er offentlig hvis tilgang til informasjonen er tillatt, og informasjonen er synlig for alle ikke-anonyme brukere. Hvis bare én ikke-anonym bruker er spesifikt nektet tilgang til medlemskapsinformasjon, er ikke informasjonen om gruppemedlemskap offentlig.
Obs! Denne objektmodellen støttes ikke når alternativet Deaktiver funksjoner fra oppdateringspakke under Avansert-kategorien i Alternativer-dialogboksen i InfoPath er valgt, eller når Microsoft Office 2003 Service Pack 1 eller senere ikke er installert. Skjemaer som implementerer dette objektmodellmedlemmet i kode, vil generere en feilmelding hvis de åpnes i InfoPath nå oppdateringspakkefunksjoner er deaktivert eller ikke er tilgjengelige.
Eksempel
I eksempelet nedenfor brukes IsUserMemberOf-metoden for User-objektet til å fastsette om den gjeldende brukeren er medlem av gruppen "GroupDomain\Administrators".
var fGroupMatched;
fGroupMatched = Application.User.IsUserMemberOf("GroupDomain\Administrators")