ModifyAccessRequest-klasse

Artikel
07/17/2015

Contains the data that is needed to replace the access rights on the target record for the specified security principal (user or team).

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 ModifyAccessRequest
    Inherits OrganizationRequest

[DataContractAttribute(Namespace="https://schemas.microsoft.com/crm/2011/Contracts")] 
public sealed class ModifyAccessRequest : 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.


// Grant the first user delete access to the lead.
var modifyUser1AccessReq = new ModifyAccessRequest
{
    PrincipalAccess = new PrincipalAccess
    {
        AccessMask = AccessRights.DeleteAccess,
        Principal = systemUser1Ref
    },
    Target = leadReference
};

Console.WriteLine("Granting delete access to {0} on the lead...\r\n",
    GetEntityReferenceString(systemUser1Ref));
_serviceProxy.Execute(modifyUser1AccessReq);

Bemærkninger

Message Availability

Denne meddelelse fungerer kun, hvis den kaldende har forbindelse til serveren.

Usage

Pass an instance of this class to the Execute method, which returns an instance of the ModifyAccessResponse class.

Privileges and Access Rights

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

Notes for Callers

This action applies to all child records of the target entity record. For all child records, if the caller does not have share privileges for those entity types or share rights to the records, the child records are not shared. As a result, the owner of the entity record, or a user who shares the record that has share rights, automatically has share rights to all child records of the target entity record. In this case, only the lack of privileges to a particular entity type prevents the child records from being shared.

For a description of how actions on a parent record affect child records, see Cascading Behavior.

Supported Entities

I følgende tabel vises de standardobjekter, der understøtter denne meddelelse. Denne meddelelse er kun tilgængelig i forbindelse med de viste objekter, hvis den kaldende har forbindelse til serveren.

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

Nedarvningshierarki

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

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

ModifyAccessRequest-medlemmer
Microsoft.Crm.Sdk.Messages-navneområde
Actions on Entity Records
ModifyAccessResponse

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