IBindCtx::RevokeObjectBound

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method releases the IUnknown pointer to the specified object and removes that pointer from the bind context's internal list of pointers. This will undo a previous call to the IBindCtx::RegisterObjectBound method for the same object.

The IBindCtx::RevokeObjectBound method is supported in DCOM, but it is not supported in COM. Calling this method in COM returns a value of E_NOTIMPL.

Syntax

HRESULT RevokeObjectBound(
  IUnknown* punk
);

Parameters

  • punk
    [in] Pointer to the IUnknown interface on the object to be released.

Return Value

The following table shows the return values for this method.

Value Description

S_OK

The object was released successfully.

MK_E_NOTBOUND

Indicates that punk was not previously registered with a call to IBindCtx::RegisterObjectBound.

Remarks

You rarely call this method. This method is included for completeness.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header objidl.h, objidl.idl
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IUnknown
IBindCtx::RegisterObjectBound