3.2.5.2.1.19 INtmsLibraryControl1::EndNtmsDeviceChangeDetection (Opnum 22)

  • Article

The EndNtmsDeviceChangeDetection method ends device change detection for one or more target devices. Implementation of this method is optional.<27> The server MAY return a non-implemented error (ERROR_CALL_NOT_IMPLEMENTED, 0x80070078). <28>

 HRESULT EndNtmsDeviceChangeDetection(
   [in] NTMS_HANDLE DetectHandle
 );

DetectHandle: The device change detection handle to close. The handle MUST have come from a prior BeginNtmsDeviceChangeDetection method invocation.

Return value/code

Description

0x00000000

S_OK

The call was successful.

0x80070006

ERROR_INVALID_HANDLE

The session handle was is not valid.

0x80070078

ERROR_CALL_NOT_IMPLEMENTED

This function is not supported on this system.

If the method is implemented, the server MUST verify that DetectHandle is not NULL. If it is NULL, the server MUST immediately fail the operation and return an invalid handler error ERROR_INVALID_HANDLE (0x80070006).

The EndNtmsDeviceChangeDetection method ends device change detection for any target devices specified using the SetNtmsDeviceChangeDetection method, and closes the change detection handle.

Closing the RSM session also ends all device change detection sessions.