ModifyAccessRequest 类
应用到: CRM 2015 on-prem, CRM Online
Contains the data that is needed to replace the access rights on the target record for the specified security principal (user or team).
命名空间: Microsoft.Crm.Sdk.Messages
程序集: Microsoft.Crm.Sdk.Proxy (在 Microsoft.Crm.Sdk.Proxy.dll 中)
语法
声明
<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
示例
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);
备注
Message Availability
若要使此消息正常工作,调用方必须连接到服务器。
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
下表显示支持此消息的默认实体。对于列出的实体,调用方必须连接到服务器才能使此消息可用。
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) |
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) |
继承层次结构
System.Object
Microsoft.Xrm.Sdk.OrganizationRequest
Microsoft.Crm.Sdk.Messages.ModifyAccessRequest
线程安全性
此类型的所有公共静态(Visual Basic 中的 Shared)成员都是线程安全成员。不保证任何实例成员是线程安全成员。
平台
开发平台
Windows Vista、Windows Server 2003 和
目标平台
Windows Vista,Windows XP
Change History
另请参阅
参考
ModifyAccessRequest 成员
Microsoft.Crm.Sdk.Messages 命名空间
Actions on Entity Records
ModifyAccessResponse
其他资源
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
Send comments about this topic to Microsoft.
© 2014 Microsoft Corporation. All rights reserved.