GetObject method

[IHlinkBrowseContext::GetObject may be altered or unavailable in subsequent versions of the operating system or product.]

Note The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

Gets an object that was registered in the browse context under the given name.

Syntax

HRESULT retVal = object.GetObject(pimk, fBindIfRootRegistered, ppiunk);

Parameters

  • pimk [in]
    Type: IMoniker

    The address of an IMoniker interface.

  • fBindIfRootRegistered [in]
    Type: BOOL

    A boolean value that indicates whether the browse context is registered. If TRUE, the browse context binds this method to the moniker. If the object referred to by pimk is not registered in the browse context, the browse context gets the object.

  • ppiunk [out]
    Type: IUnknown

    A pointer to the IUnknown interface of the object being retrieved.

Remarks

If the object in pimk is not registered in the browse context, this method binds to the full moniker and gets the object, if the following conditions are met.

  • fBindIfRootRegistered is set to TRUE.
  • The moniker refers to an embedded object. The moniker pimk is a generic composite moniker.
  • The root object of the containment hierarchy is registered with the browse context.

See also

IHlinkBrowseContext::Register