Share via

IDSAddIn::OnConnection

  • Article

This method loads an add-in.

HRESULT OnConnection (
  IApplication* pApp,
  VARIANT BOOL bFirstTime,
  Long dwCookie 
  VARIANT_BOOL* OnConnection
);

Parameters

  • pApp
    [in] Pointer to the dual interface on the IApplication method.
  • bFirstTime
    [in, out] Determines if this is the first time the add-in has been loaded into the environment. If it is the first time, bFirstTime is VARIANT_TRUE, and the add-in can add new toolbar buttons or key sequences for carrying out its commands. Note that if you disconnect the add-in and then reconnect it, bFirstTime is also VARIANT_TRUE.
  • dwCookie
    [in] Cookie that identifies the add-in in subsequent calls. For example, the add-in uses this cookie to call the IApplication method.

Return Values

If the add-in loads successfully, it returns VARIANT_TRUE. If required objects are not available, the add-in returns VARIANT_FALSE, indicating that it should not be loaded.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Addauto.h.
Link Library: Developer implemented.

See Also

Macros and Add-ins | IDSAddIn::OnDisconnection | IApplication::AddCommand | IApplication::SetAddInInfo

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.