OpenNtmsNotification

[This is preliminary documentation and subject to change.]

The OpenNtmsNotification function opens a channel to receive RSM object change notifications for objects of the specified type.

HANDLE WINAPI OpenNtmsNotification(
  HANDLE hSession,
  DWORD dwType
);
 

Parameters

hSession
Handle to the session returned by the OpenNtmsSession function.
dwType
Specifies the RSM object type for notification.

Return Values

ERROR_DATABASE_FAILURE
The database query or update failed.
ERROR_INVALID_HANDLE
The value specified in the hSession parameter is invalid or NULL.
ERROR_NOT_CONNECTED
Unable to connect to the RSM service.
ERROR_SUCCESS
The function was successful.
INVALID_HANDLE_VALUE
The function failed.

Remarks

The OpenNtmsNotification function returns a notification handle that you pass to the WaitForNtmsNotification or CloseNtmsNotification functions.

For extended error information, call the Win32 GetLastError function.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in ntmsapi.h.
  Import Library: Use ntmsapi.lib.

See Also

Database Notification Functions, CloseNtmsNotification, WaitForNtmsNotification