UpdateDelegate 操作
UpdateDelegate 操作は、プリンシパルのメールボックスに対する委任アクセス許可を更新します。
SOAP ヘッダー
UpdateDelegate 操作では、次の表に記載されている SOAP ヘッダーを使用できます。
Header | 要素 | 説明 |
---|---|---|
偽装 |
ExchangeImpersonation |
クライアント アプリケーションが偽装しているユーザーを識別します。 |
MailboxCulture |
MailboxCulture |
メールボックスへのアクセスに使用する RFC3066 カルチャを識別します。 |
RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 |
ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 |
UpdateDelegate 要求の例
説明
次の UpdateDelegate 要求の例は、user1 のアカウントに対する委任アクセス許可を更新する方法を示しています。 User2 には、Tasks フォルダーの None アクセス許可レベルが付与され、プライベートアイテムを表示するためのアクセス許可が付与されます。 User3 には、ジャーナル フォルダーに対するレビュー担当者のアクセス許可が付与されます。 会議出席依頼は代理人に送信され、要求に関する情報は User1 に送信されます。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1"/>
</soap:Header>
<soap:Body>
<UpdateDelegate xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<Mailbox>
<t:EmailAddress>user1@example.com</t:EmailAddress>
</Mailbox>
<DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user2@example.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
</t:DelegatePermissions>
<t:ViewPrivateItems>true</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>user3@example.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:JournalFolderPermissionLevel>Reviewer</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
</t:DelegateUser>
</DelegateUsers>
<DeliverMeetingRequests>DelegatesAndSendInformationToMe</DeliverMeetingRequests>
</UpdateDelegate>
</soap:Body>
</soap:Envelope>
Comments
UpdateDelegate 要求では、デリゲートに更新プログラムを適用する必要はありません。 クライアントは DeliverMeetingMessage 設定のみを変更できます。
UpdateDelegate 応答の例
説明
次の例は、 UpdateDelegate 操作に対する正常な応答を示しています。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8"
MinorVersion="1"
MajorBuildNumber="206"
MinorBuildNumber="0"
Version="Exchange2007_SP1"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<m:UpdateDelegateResponse xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ResponseClass="Success"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1333220396-2200287332-232816053-1117</t:SID>
<t:PrimarySmtpAddress>User2@example.com</t:PrimarySmtpAddress>
<t:DisplayName>User2</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>true</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>true</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1333220396-2200287332-232816053-1118</t:SID>
<t:PrimarySmtpAddress>User3@example.com</t:PrimarySmtpAddress>
<t:DisplayName>User3</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>true</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:UpdateDelegateResponse>
</soap:Body>
</soap:Envelope>
UpdateDelegate エラー応答の例
説明
次の例は、 UpdateDelegate 要求に対するエラー応答を示しています。 デリゲートがプリンシパルのデリゲート リストに存在しないため、エラーが生成されました。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8"
MinorVersion="1"
MajorBuildNumber="206"
MinorBuildNumber="0"
Version="Exchange2007_SP1"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<m:UpdateDelegateResponse xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
ResponseClass="Success"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Error">
<m:MessageText>The user is not a delegate for the mailbox.</m:MessageText>
<m:ResponseCode>ErrorNotDelegate</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:UpdateDelegateResponse>
</soap:Body>
</soap:Envelope>