Theater SDK Banner 

Art
[Previous][Next]

INSSEventNotification::OnEvent

Called when specified events are sent from the server.

Syntax

HRESULT OnEvent (
NSS_EVENT          *pEvent,
INSSUserContext      *pUser,
INSSPresentationContext   *pPresentation,
INSSCommandContext    *pCommand
);

Parameters

[in] pEvent

Specifies a pointer to the event and the results of authorization.

[in] pUser

Specifies a pointer to the user context property map interface. The user context is used to store information about the client. For more information about the user context and its properties, see Event Authorization and Notification Contexts.

[in] pPresentation

Specifies a pointer to the presentation context property map interface. The presentation context is used to store information about the presentation. For more information about the presentation context and its properties, see Event Authorization and Notification Contexts.

[in] pCommand

Specifies a pointer to the command context. This parameter can be NULL.

Return Values

This method must return S_OK upon successful completion, or an HRESULT error value.

Remarks

The following code illustrates a skeletal implementation of the INSSEventNotification::OnEvent method:

HRESULT
CEventNotification::OnEvent( 
        NSS_EVENT __RPC_FAR *pEvent,
        INSSUserContext __RPC_FAR *pUser,
        INSSPresentationContext __RPC_FAR *pPresentation,
        INSSCommandContext __RPC_FAR *pCommand
        )
//
// Event Logging routine goes here
//
{
  return( S_OK );
}

See Also

INSSEventNotification::GetHandledEvents

[Previous][Next]



© 1996-1998 Microsoft Corporation. All rights reserved