3.2.5.2.5.13 INtmsSession1::DispatchNotification (Opnum 16)
The DispatchNotification method sends a notification to all registered sinks.
-
HRESULT DispatchNotification( [in] DWORD dwType, [in] DWORD dwOperation, [in] LPNTMS_GUID lpIdentifier );
dwType: A value from the NtmsObjectsTypes (section 2.2.1.6) enumeration specifying the type of object to which the notification refers.
dwOperation: A value from the NtmsNotificationOperations (section 2.2.1.8) enumeration specifying the type of operation to which the notification refers.
lpIdentifier: A pointer to the identifier of the event for which notification is being sent.
-
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 send an input notification of type dwType to all registered sinks. If the client does not have the required access rights, the server MUST return ERROR_ACCESS_DENIED (0x80070005) and no further action is taken.
The server MUST return value returned by client sink.