188.8.131.52.1.17 INtmsLibraryControl1::BeginNtmsDeviceChangeDetection (Opnum 20)
The BeginNtmsDeviceChangeDetection method begins a device change detection session. The libraries for which media change detection is required MUST be set using the SetNtmsDeviceChangeDetection method. Implementation of this method is optional.<23> The server MAY return a non-implemented error (ERROR_CALL_NOT_IMPLEMENTED, 0x80070078).<24>
HRESULT BeginNtmsDeviceChangeDetection( [out] NTMS_HANDLE* lpDetectHandle );
lpDetectHandle: A pointer to the new device change detection handle.
The call was successful.
The session handle is not valid.
A parameter is not valid.
This function is not supported on this system.
If the method is implemented, the server MUST verify that lpDetectHandle 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 BeginNtmsDeviceChangeDetection method allows the application to begin a device change detection session.
After calling BeginNtmsDeviceChangeDetection, the application can set the stand-alone libraries for which media change detection is required using the SetNtmsDeviceChangeDetection method. RSM continues to detect changes for the devices specified until the change detection session is closed using the EndNtmsDeviceChangeDetection method.
The server MUST return a pointer to the new device change detection handle in lpDetectHandle.