Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function registers a window handle for connection status notifications.
Syntax
HRESULT WINAPI ConnMgrRegisterForStatusChangeNotification( BOOL fEnable, HWND hWnd ); |
Parameters
- fEnable
-
[in] Enables or disables status change notifications.
- hWnd
-
[in] Handle to the window to which to post status change notifications.
Return Values
This function returns the following values.
Value | Description |
---|---|
S_OK |
The function call was successful. |
E_HANDLE |
The supplied window handle is invalid. |
E_ACCESSDENIED |
The calling process does not have sufficient privileges to use this function. |
Remarks
When any of the connections changes its state from connected to disconnected, or from disconnected to connected, ConnMgrRegisterForStatusNotificationposts a CONNMGR_STATUS_CHANGE_NOTIFICATION_MSGmessage to the window that has the hWndwindow handle. This function also posts a message when a new connection is created.
During the lifetime of the connection, any Connection Manager status constant can be passed to the notification window, in addition to the CONNMGR_STATUS_CONNECTED and CONNMGR_STATUS_DISCONNECTED constants. For more information, see Connection Manager Status Constants.
Requirements
Header | connmgr_status.h |
Library | cellcore.lib |
Windows Embedded CE | Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009 |
Windows Mobile | Windows Mobile Version 5.0 and later |