ConnMgrRegisterForStatusNotification

Send Feedback

This function registers a window handle for connection status notifications.

HRESULT WINAPI ConnMgrRegisterForStatusChangeNotification(
  BOOL fEnable,
  HWND hWnd
);

Parameters

  • fEnable
    [in] Enables or disables 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

ConnMgrRegisterForStatusNotification will post a CONNMGR_STATUS_CHANGE_NOTIFICATION message to the window that has the passed-in window handle when any of the connections changes its state from connected to disconnected, or disconnected to connected. This function will post 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.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Connmgr_status.h.
Link Library: Cellcore.lib.

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.