DMsgrSessionEvents::BeforeAppLaunch Event

  • Article

Deprecated. Fires when the session's application is about to be launched.

Syntax

void BeforeAppLaunch(      
    VARIANT_BOOL *pBoolfEnableDefault
);

Parameters

  • pBoolfEnableDefault
    [in, out] Pointer to a VARIANT_BOOL that defines one of the following possible values.
    • VARIANT_FALSE
      Application launch disabled.
    • VARIANT_TRUE
      Default. Application launch enabled.

Return Value

No return value.

Event DISPID

DISPID_BEFOREAPPLAUNCH

The DISPID for this event is defined in msgrpriv.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

Remarks

The value of pBoolfEnableDefault indicates whether a Messenger client will launch the session's application when this event is received. To disable a Messenger client from launching the session's application, the application must set this value to VARIANT_FALSE.

Important  DMsgrSessionEvents::BeforeAppLaunch is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

DMsgrSessionEvents::OnAppNotPresent, DMsgrSessionEvents::OnCancelled, DMsgrSessionEvents::OnContextData, DMsgrSessionEvents::OnDeclined, DMsgrSessionEvents::OnReadyToLaunch, DMsgrSessionEvents::OnSendError, DMsgrSessionEvents::OnStateChanged, DMsgrSessionEvents::OnTermination, Messenger Lock and Key API, Messenger Session Invite and Messenger Private APIs