Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide

Page of 546
 
Chapter 8      Session Object
Methods
8-22
Cisco ICM Software CTI OS Developer’s Guide Release 6.0(0)
COM: 
HRESULT GetObjectFromObjectID (/*[in]*/ BSTR uniqueObjectID, 
/*[out]*/ IDispatch ** object, /*[out, retval]*/ VARIANT_BOOL * 
errorcode);
VB: 
GetObjectFromObjectID(uniqueObjectID As String, object as 
IDispatch) As Boolean
Java:
CtiOsObject GetObjectFromObjectID(java.lang.String sUID)
Parameters
uniqueObjectID
A string reference that contains the UniqueObjectID of the requested Call, 
Agent, or Skillgroup object.
object
A pointer to either a CTIOSObject in C++ (which is a CILRefArg) or an 
IDispatch * pointing to either an ICall, an IAgent, or an ISkillGroup in COM.
errorcode
An output parameter (return parameter in VB) that contains an error code 
from 
 in 
Return Values
C++: 
Default HRESULT return value. See 
Others: 
A boolean indicating success or failure of the method.
The C++ and Java versions of this method return NULL if the value requested is 
not found or if there is an error.
Remarks
Many events use UniqueObjectIDs instead of the objects themselves. Use this 
method to get the object if it is necessary for processing.
GetPropertyName
See 
 for a description of the GetPropertyName method.