UccOperationContext Class
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Represents a co-creatable class for an application-defined operational context. The class can be co-created.
Namespace: Microsoft.Office.Interop.UccApi
Assembly: Microsoft.Office.Interop.UccApi (in microsoft.office.interop.uccapi.dll)
Syntax
'Declaration
Public Class UccOperationContext
public class UccOperationContext
public ref class UccOperationContext
public class UccOperationContext
public class UccOperationContext
Remarks
This class implements the IUccOperationContext interface. The default interface is IUccOperationContext. An application obtains the default interface on the class instance directly. Non-default interfaces, if any, can be obtained by calling QueryInterface on the default interface. This class can be co-created.
Unified Communications Client API supports this interface to provide a means correlate requests with the corresponding asynchronous responses. A client can assign an operational ID to indicate the sequence of a particular request. The client can then read the operation ID of a response to ascertain if the response matches the request. Other contextual information can be dispatched as well. The contextual information a client can dispatch with an operation is encapsulated by an IUccContext instance and held by the Context property of UccOperationContext. An event handler that receives an event corresponding to the executed operation has access to the original operation context by means of the event data argument passed to the event handler.
Win32 COM/C++ Syntax
coclass UccOperationContext
{
[default] interface IUccOperationContext;
};
Inheritance Hierarchy
System.Object
Microsoft.Office.Interop.UccApi.UccOperationContext
Example
Creating a new instance of the UccOperationContext class is simply a matter of calling the default constructor for the class as follows. Once a new UccOperationContext class is created, an application should create an IUccContext instance with at least one property value.
/// <summary>
/// Taking a property key and value, method creates
/// an operation context and returns value
/// </summary>
/// <param name="Id">Operation Id assigned to operation</param>
/// <param name="key">named property key</param>
/// <param name="value">named property value</param>
/// <returns>initialized operation context object</returns>
private UccOperationContext createOperationContext(int opId, string key, string value)
{
UccOperationContext oc = new UccOperationContext();
UccContext c = new UccContextClass();
c.AddNamedProperty(key, value);
oc.Initialize(opId, c);
return oc;
}
Thread Safety
All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.
Platforms
Development Platforms
Windows XP Professional with Service Pack 2 (SP2), Windows Server 2000 with Service Pack 4, Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition
Target Platforms
See Also
Reference
UccOperationContext Members
Microsoft.Office.Interop.UccApi Namespace