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