WaitForNtmsNotification
[This is preliminary documentation and subject to change.]
The WaitForNtmsNotification function waits for the next object change notification.
DWORD WINAPI WaitForNtmsNotification(
HANDLE hSession,
HANDLE hNotification,
LPNTMS_NOTIFICATIONINFORMATION lpNotificationInformation,
DWORD dwTimeout
);
Parameters
-
hSession
-
Handle to the session returned by the OpenNtmsSession function.
-
hNotification
-
Notification handle generated by the OpenNtmsNotification function.
-
lpNotificationInformation
-
Specifies notification information. For more information, see the NTMS_NOTIFICATIONINFORMATION data structure.
-
dwTimeout
-
Specifies the maximum number of milliseconds to wait. If you specify a value of INFINITE, this function will not time-out.
Return Values
-
ERROR_DATABASE_FAILURE
-
The database query or update failed.
-
ERROR_INVALID_HANDLE
-
The value specified in the hNotification parameter is invalid or NULL.
-
ERROR_NO_DATA
-
Notification pipe failed. Attempt to set up notification again.
-
ERROR_NOT_CONNECTED
-
Unable to connect to the RSM.
-
ERROR_TIMEOUT
-
The time-out event expired.
-
ERROR_SUCCESS
-
The function was successful.
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, OpenNtmsNotification