CheckPermissions(string,string,string) function

Microsoft Office Live Communications Server 2005 with SP1

CheckPermissions

The CheckPermissions function determines whether a user can send a certain type of SIP method to another user.

string CheckPermissions(
  string from,
  string to,
  string action
);

Parameters

• from
  A SIP "user@host" URI string that represents the action sender.
• to
  A SIP "user@host" URI string that represents the action recipient.
• action
  The type of SIP method whose permission level is to be verified on the recipient.

  Value	Description
  I	Queries whether the user in the from parameter is allowed to send a SIP INVITE or MESSAGE method to the user in the to parameter.
  S	Queries whether the user in the from parameter is allowed to send a SIP SUBSCRIBE method to the user in the to parameter.

Return Values

One of the following characters that indicate the response of the user in the to parameter to the action taken by the user in the from parameter.

Return code	Description
A	Allow. The action can be performed on the recipient.
B	Block. The action is blocked on the recipient.
D	Deny. The sender is denied access on the recipient.
P	Prompt. The recipient will be prompted to confirm the action.

Remarks

This function will return "B" by default if the sender or the recipient (or both) is not a valid SIP URI.

What did you think of this topic?

© 2008 Microsoft Corporation. All rights reserved.