This documentation is archived and is not being maintained.

GetInterface Method (IPerson)

EWS Managed API

Topic Last Modified: 2006-06-13

Returns the specified dual interface on the object.

Applies To

IPerson Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In


Function GetInterface(    ByVal Interface As String) As Object
HRESULT GetInterface
        BSTR Interface,
        IDispatch** ppUnknown


The name of interface to obtain. The list of possible interfaces to return depends upon the Component Object Model (COM) class that provides the implementation.


If the method succeeds, then on return, the address passed holds a reference to the requested interface.

Returns S_OK if successful, or an error value otherwise.

The GetInterface method is primarily intended as a generic interface navigation aid to scripting languages that do not support such navigation directly. Most COM classes that provide implementations of the IMessage interface expose additional dual interfaces that are accessible by scripting languages only through properties on the interface, such as BodyPart and DataSource, or through using the GetInterface method. When properties do not exist on the interface to return these interfaces, the GetInterface method must be used.

The list of valid interface names to pass to GetInterface is dependent upon a specific implementation. As a general rule, the name of the desired interface should match the physical name of the interface as it appears in the type library or idl file. Check the appropriate COM class for a list of exposed dual interfaces. If the object does not support the requested interface, an exception is raised with the HRESULT value of E_INVALIDARG.

Dim iPrs
Set iPrs = CreateObject("CDO.Person")
Dim iDsrc
Set iDsrc = iPrs.GetInterface("IDataSource")