3.2.5.2.5.11 INtmsSession1::AddNotification (Opnum 14)

The AddNotification method registers a client to receive change notifications for a type of object.

 HRESULT AddNotification(
   [in] DWORD dwType
 );

dwType: A value from the NtmsObjectsTypes (section 2.2.1.6) enumeration specifying the type of object for which the client wants to receive change notifications.

Return value/code

Description

0x00000000

S_OK

The call was successful.

Upon receiving this message, the server MUST verify that dwType is a valid notification type, verify that the user has the required access rights, and set the server to send back notifications of dwType type.

If parameter validation fails, the server MUST NOT be set to send back notifications, MUST return S_OK (0x00000000), and take no further action.