RetrieveSharedPrincipalsAndAccessRequest-klasse

Artikel
07/17/2015

Contains the data that is needed to retrieve all security principals (users or teams) that have access to, and access rights for, the specified record.

Navneområde: Microsoft.Crm.Sdk.Messages
Assembly: Microsoft.Crm.Sdk.Proxy (i Microsoft.Crm.Sdk.Proxy.dll)

Syntaks

'Deklaration
<DataContractAttribute(Namespace:="https://schemas.microsoft.com/crm/2011/Contracts")> _
Public NotInheritable Class RetrieveSharedPrincipalsAndAccessRequest
    Inherits OrganizationRequest

[DataContractAttribute(Namespace="https://schemas.microsoft.com/crm/2011/Contracts")] 
public sealed class RetrieveSharedPrincipalsAndAccessRequest : OrganizationRequest

Eksempel

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. For the complete sample, see the link later in this topic.

var accessRequest = new RetrieveSharedPrincipalsAndAccessRequest
{
    Target = leadReference
};

// The RetrieveSharedPrincipalsAndAccessResponse returns an entity reference
// that has a LogicalName of "user" when returning access information for a
// "team."
var accessResponse = (RetrieveSharedPrincipalsAndAccessResponse)
    _serviceProxy.Execute(accessRequest);
Console.WriteLine("The following have the specified granted access to the lead.");
foreach (var principalAccess in accessResponse.PrincipalAccesses)
{
    Console.WriteLine("\t{0}:\r\n\t\t{1}",
        GetEntityReferenceString(principalAccess.Principal),
        principalAccess.AccessMask);
}
Console.WriteLine();

Bemærkninger

Message Availability

Denne meddelelse fungerer, uanset om den kaldende har forbindelse til serveren eller arbejder offline. However, a few entities of this message class are exceptions to that availability. To determine which entities have a more restricted availability, see Supported Entities later in this topic.

Usage

Overfør en forekomst af denne klasse til Execute method, which returns an instance of the RetrieveSharedPrincipalsAndAccessResponse class.

Privileges and Access Rights

To perform this action, the caller must have the privileges on the specified entity in the Target property and access rights on the specified record in the Target property. For a complete list of the required privileges, see the topic RetrieveSharedPrincipalsAndAccess Privileges.

Supported Entities

I følgende tabel vises de standardobjekter, der understøtter denne meddelelse. For de viste objekter i denne meddelelse vises Server i kolonnen Tilgængelighed, hvis den kaldende skal have forbindelse til serveren, og der vises Begge, hvis den kaldende både kan have forbindelse til eller ikke have forbindelse til serveren.

Entity	Availability
Account	2 (Both)
Annotation	2 (Both)
Appointment	2 (Both)
Campaign	2 (Both)
CampaignActivity	2 (Both)
CampaignResponse	2 (Both)
Connection	2 (Both)
Contact	2 (Both)
Contract	2 (Both)
ConvertRule	2 (Both)
CustomerOpportunityRole	2 (Both)
CustomerRelationship	2 (Both)
DuplicateRule	2 (Both)
Email	2 (Both)
EmailServerProfile	2 (Both)
Entitlement	2 (Both)
Fax	2 (Both)
Goal	2 (Both)
GoalRollupQuery	2 (Both)
Import	2 (Both)
ImportFile	2 (Both)
ImportMap	2 (Both)
Incident	2 (Both)
IncidentResolution	2 (Both)
Invoice	2 (Both)
Lead	2 (Both)
Letter	2 (Both)
List	2 (Both)
Mailbox	2 (Both)
MailMergeTemplate	2 (Both)
msdyn_PostAlbum	2 (Both)
msdyn_wallsavedqueryusersettings	2 (Both)
Opportunity	2 (Both)
OpportunityClose	2 (Both)
OrderClose	2 (Both)
PhoneCall	2 (Both)
ProcessSession	2 (Both)
Queue	2 (Both)
Quote	2 (Both)
QuoteClose	2 (Both)
RecurringAppointmentMaster	2 (Both)
Report	2 (Both)
RoutingRule	2 (Both)
SalesOrder	2 (Both)
ServiceAppointment	2 (Both)
SharePointDocumentLocation	2 (Both)
SharePointSite	2 (Both)
SLA	2 (Both)
SLAKPIInstance	2 (Both)
SocialActivity	2 (Both)
SocialProfile	2 (Both)
Task	2 (Both)
Template	2 (Both)
UserForm	2 (Both)
UserQuery	2 (Both)
UserQueryVisualization	2 (Both)
Workflow	2 (Both)

Nedarvningshierarki

System.Object
Microsoft.Xrm.Sdk.OrganizationRequest
Microsoft.Crm.Sdk.Messages.RetrieveSharedPrincipalsAndAccessRequest

Sikkerhed i tråd

Alle offentlige statiske (Shared i Visual Basic) medlemmer af denne type er trådsikret. Alle medlemmer af forekomsten er ikke garanteret trådsikkerhed.

Platforme

Development Platforms

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Target Platforms

Windows Server 2008,Windows Server 2012,Windows 7

Change History

Se også

Reference

RetrieveSharedPrincipalsAndAccessRequest-medlemmer
Microsoft.Crm.Sdk.Messages-navneområde
Entity Ownership
RetrieveSharedPrincipalsAndAccessResponse

Andre ressourcer

How Record-Based Security Can Be Used to Control Access to Records In Microsoft Dynamics CRM
Sample: Share Records Using GrantAccess, ModifyAccess and RevokeAccess Messages

Del via