Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Requests an IDispatchpointer to the extended control that the container uses to wrap the real control.

Syntax

HRESULT GetExtendedControl( 
  IDispatch** 
ppDisp  
);

Parameters

ppDisp

[out] Address of IDispatch* pointer variable that receives the interface pointer to the extended control. If an error occurs, the implementation must set * ppDispto NULL. On success, the caller is responsible for calling IDispatch::Releasewhen * ppDispis no longer needed.

Return Value

This method supports the following return values:

Value Description

S_OK

The extended control's IDispatchis returned in ppDisp.

E_NOTIMPL

The container does not implement extended controls.

E_OUTOFMEMORY

The call to the method failed due to lack of memory.

E_POINTER

The address in ppDispor * ppDispis not valid. For example, it may be NULL.

E_UNEXPECTED

The call to the method unexpectedly failed.

Remarks

This method gives the real control access to whatever properties and methods the container maintains in the extended control. These properties and methods would otherwise be inaccessible to the control.

Notes to Callers

The returned pointer is the responsibility of the caller, which must release it when it is no longer needed.

Requirements

Header ocidl.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

COM Interfaces