DMsgrSessionEvents::BeforeAppLaunch event

[BeforeAppLaunch is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

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

Syntax

void BeforeAppLaunch(
  [in, out] VARIANT_BOOL *pBoolfEnableDefault = VARIANT_TRUE
);

Parameters

pBoolfEnableDefault [in, out]

Pointer to a VARIANT_BOOL that defines one of the following possible values.

Value Meaning
VARIANT_FALSE
false
Application launch disabled.
VARIANT_TRUE
true
Application launch enabled.

Return value

This event does not return a value.

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.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Product
Messenger 4.5
Header
Msgrpriv.h
IDL
Msgrpriv.idl
DLL
Msnmsgrexe.adeb440d_7847_4f65_80bd_899870ed2ec9

See also

DMsgrSessionEvents

OnAppNotPresent

OnCancelled

OnContextData

OnDeclined

OnReadyToLaunch

OnSendError

OnStateChanged

OnTermination

Messenger Lock and Key API

Messenger Session Invite and Messenger Private APIs