GetInterface Method

[This is preliminary documentation and subject to change.]

Returns the specified dual interface on the object.

[Visual Basic,VBScript]
Function GetInterface(ByVal Interface as String) as Object
[C++]
HRESULT GetInterface( BSTR Interface, IDispatch** ppUnknown);
[IDL]
HRESULT GetInterface([in] BSTR Interface, [out,retval] IDispatch** ppUnknown);

Interface

The name of interface to obtain. The list of possible interfaces to return depends upon the COM class that provides the implementation.

ppUnknown [C++,IDL]

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

Remarks

The GetInterface method is primarily intended as a generic interface navigation aid for 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.. When the interface does not have properties to return these interfaces, use the GetInterface method.

The list of valid interface names to pass to GetInterface depends 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 an object does not support the requested interface, an exception is raised with the HRESULT value of E_INVALIDARG.

Example

Dim iAppt
Set iAppt = iCalPart.GetInterface("IAppointment")