3.2.5.2.5.12 INtmsSession1::RemoveNotification (Opnum 15)

The RemoveNotification method unregisters a client from receiving change notifications for a type of object.

 HRESULT RemoveNotification(
   [in] DWORD dwType
 );

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

Return value/code

Description

0x00000000

S_OK

The call was successful.

0x80070005

ERROR_ACCESS_DENIED

Access to an object was denied.

Upon receiving this message, the server MUST verify that dwType is a valid notification type. If it is not, the server MUST return S_OK (0x00000000) and take no further action.

If parameter validation succeeds, the server MUST verify that the user has the required access rights, and set the server to stop sending notifications of dwType type. If the client does not have the required access rights, the server MUST return ERROR_ACCESS_DENIED (0x80070005) and no further action is taken.