MoveToNtmsMediaPool 함수(ntmsapi.h)
[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]
MoveToNtmsMediaPool 함수는 지정된 매체를 현재 미디어 풀에서 지정된 미디어 풀로 이동합니다.
구문
DWORD MoveToNtmsMediaPool(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaId,
[in] LPNTMS_GUID lpPoolId
);
매개 변수
[in] hSession
OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.
[in] lpMediaId
물리적 미디어 조각의 고유 식별자입니다.
[in] lpPoolId
대상 미디어 풀의 고유 식별자입니다.
반환 값
이 함수는 다음 값 중 하나를 반환합니다.
| 값 | 의미 |
|---|---|
|
미디어의 미디어 풀에 대한 NTMS_CONTROL_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
Windows XP: 원본 미디어의 미디어 풀 또는 대상 미디어 풀에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다. |
|
미디어의 한 쪽 이상이 사용 중이거나 현재 사용할 수 없습니다. |
|
데이터베이스에 액세스할 수 없거나 손상되었습니다. |
|
데이터베이스가 가득 찼습니다. |
|
세션 핸들이 없거나 잘못되었습니다. |
|
대상 미디어 풀이 잘못되었습니다. 미디어 풀이 존재하지 않습니다. 또는 인식할 수 없는 또는 가져오기 풀의 미디어는 무료 풀로만 이동할 수 있습니다. |
|
원본 미디어 또는 암시적 원본 미디어 풀이 잘못되었습니다. |
|
미디어 ID 또는 미디어 풀 ID가 없습니다. |
|
원본의 미디어 유형은 대상 미디어 풀의 미디어 유형과 다릅니다. |
|
처리하는 동안 할당 오류가 발생했습니다. |
|
함수가 성공했습니다. |
설명
MoveToNtmsMediaPool 함수에 지정된 대상 풀은 동일한 미디어 형식이어야 하며 호환되는 보안이 있어야 합니다.
RSM은 미디어를 무료 미디어 풀로 이동하기 전에 미디어에 미디어 식별자를 씁니다.
완료됨, 할당됨 또는 예약된 상태에 파티션이 있는 매체는 무료 미디어 풀로 이동되지 않을 수 있습니다. 매체의 모든 파티션이 가져오기 상태인 경우에만 매체를 가져오기 풀로 이동할 수 있습니다.
Windows Server 2003: 무료 풀이 원본 풀인 경우 무료 풀로 NTMS_USE_ACCESS 대상 풀로 NTMS_CONTROL_ACCESS 필요합니다. 그렇지 않으면 원본 풀과 대상 풀 모두에 NTMS_CONTROL_ACCESS 필요합니다. 무료 풀이 대상 풀인 경우 원본 풀로 NTMS_CONTROL_ACCESS 무료 풀로 NTMS_USER_ACCESS 필요합니다. 그렇지 않으면 원본 풀과 대상 풀 모두에 NTMS_CONTROL_ACCESS 필요합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | ntmsapi.h |
| 라이브러리 | Ntmsapi.lib |
| DLL | Ntmsapi.dll |