CM_NOTIFICATIONS_LISTENER_REGISTRATION (Compact 2013)
3/26/2014
This structure describes the events that are of interest to a notification listener.
Syntax
typedef struct CM_NOTIFICATIONS_LISTENER_REGISTRATION {
DWORD Version;
HANDLE hNotificationsAvailableEvent;
DWORD cRegistration;
struct {
CM_NOTIFICATION_TYPE NotificationType;
union
{
CM_SESSION_HANDLE hSession;
CM_CONNECTION_SELECTION Connection;
};
} Registration[1];
} CM_NOTIFICATIONS_LISTENER_REGISTRATION;
Members
- Version
Version of this structure according to Connection Manager Common Constants.
- hNotificationsAvailableEvent
Handle to the available notifications.
- cRegistration
Registration entry count. Tells how many connections of type notficationType the application is trying to register to. Specifies the length of Registration[]
- NotificationType
A CM_NOTIFICATION_TYPE enumeration value to register for.
- hSession
Handle to a connection session. Used to register an application to an already existing session. Referred to only when NotificationType is CMNT_SESSION_CONNECTION_SELECTION_PROGRESS.
- Connection
Contains one of the following connection selection data: name of the connection, connection type, device type, or network type. Referred to when NotificationType is not CMNT_SESSION_CONNECTION_SELECTION_PROGRESS. For more information, see CM_CONNECTION_SELECTION.
- Registration[1]
Holds details about the required connections.
Remarks
When a notification listener is registered, Connection Manager notifies the listener when the specified events are received.
Requirements
Header |
cmnet.h |
Library |
cmnet.lib |