IOleControlSite::GetExtendedControl
Requests an IDispatch
pointer to the extended control that the container uses to wrap the real
control.
HRESULT
GetExtendedControl(
|
IDispatch** ppDisp |
//Indirect pointer to the interface of the extended
control |
|
); |
|
Parameters
ppDisp
[out]
Indirectly pointer to the extended control s IDispatch interface. This
parameter is set to NULL on failure. On success, the caller is responsible for
calling IDispatch::Release when this pointer is no longer needed.
Return Values
This method
supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as
the following:
S_OK
The extended
control s IDispatch is returned in ppDisp.
E_NOTIMPL
The container
does not implement extended controls.
E_POINTER
The address
in ppDisp or *ppDisp is not valid. For example, it may be NULL.
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.