SetNtmsDeviceChangeDetection 함수(ntmsapi.h)
[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]
SetNtmsDeviceChangeDetection 함수는 변경 검색을 위해 하나 이상의 대상 디바이스를 설정합니다.
구문
DWORD SetNtmsDeviceChangeDetection(
[in] HANDLE hSession,
[in] HANDLE DetectHandle,
[in] LPNTMS_GUID lpRequestId,
[in] DWORD dwType,
[in] DWORD dwCount
);
매개 변수
[in] hSession
OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.
[in] DetectHandle
BeginNtmsDeviceChangeDetection의 디바이스 변경 검색 핸들 또는 단일 폴링에 대한 NULL입니다.
[in] lpRequestId
대상 디바이스의 개체 식별자입니다. 이 매개 변수는 하나 이상의 라이브러리, 미디어 형식 또는 물리적 미디어 GUID일 수 있습니다. 모든 GUID는 동일한 형식이어야 합니다.
[in] dwType
lpObjectId 매개 변수에 지정된 개체 식별자의 형식입니다. 이 매개 변수는 NtmsObjectsTypes 열거형 형식에서 NTMS_LIBRARY, NTMS_MEDIA_TYPE 또는 NTMS_PHYSICAL_MEDIA 값 중 하나일 수 있습니다.
[in] dwCount
lpObjectId의 개체 식별자 수입니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
세션 또는 검색 핸들이 잘못되었습니다. |
|
개체 형식이 잘못되었습니다. |
|
지정된 라이브러리를 찾을 수 없습니다. |
|
지정된 미디어 또는 형식을 찾을 수 없습니다. |
|
운영자 요청이 취소되었습니다. |
설명
디바이스는 라이브러리 GUID를 전달하거나 물리적 미디어 또는 미디어 형식 GUID를 전달하여 간접적으로 지정할 수 있습니다. 간접 사양을 사용하는 경우 미디어 또는 미디어 형식을 포함할 수 있는 모든 독립 실행형 라이브러리가 검색됩니다. EndNtmsDeviceChangeDetection 함수를 사용하여 디바이스 변경 검색 핸들을 닫을 때까지 지정된 모든 디바이스가 계속 검색됩니다.
이 함수를 사용하여 지정된 디바이스에서 변경된 미디어를 폴링할 수도 있습니다. 일반적으로 리프 노드를 열거나 새로 고침 옵션을 구현할 때 UI에서 사용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |