GetInterface Method (IItem)

Topic Last Modified: 2006-06-13

Returns the specified dual interface on the object.

Applies To

IItem Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

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

Parameters

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

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

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The GetInterface method is primarily intended as a generic interface navigation aid to scripting languages that do not support such navigation directly.

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 requested interface is not supported by the object, an exception is raised with the HRESULT value of E_INVALIDARG.

Example

Dim iAdrse
Set iAdrse = CreateObject("CDO.Addressee")
Dim iDsrc
Set iDsrc = iAdrse.GetInterface("IDataSource")