다음을 통해 공유


SwapNtmsMedia 함수(ntmsapi.h)

[Windows 7 및 Windows Server 2008 R2를 기준으로 이동식 스토리지 관리자 를 더 이상 사용할 수 없습니다.]

SwapNtmsMedia 함수는 지정된 두 LMID와 연결된 측면을 교환합니다. 지정된 LMID는 동일한 미디어 풀에 있어야 합니다.

구문

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

매개 변수

[in] hSession

OpenNtmsSession 함수에서 반환된 세션에 대한 핸들입니다.

[in] lpMediaId1

LMID(논리 미디어)의 고유 식별자입니다.

[in] lpMediaId2

LMID(논리 미디어)의 고유 식별자입니다.

반환 값

이 함수는 다음 값 중 하나를 반환합니다.

의미
ERROR_ACCESS_DENIED
두 미디어의 미디어 풀에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
ERROR_BAD_FORMAT
미디어 레이블 라이브러리가 미디어 레이블을 인식하지 않습니다.
ERROR_DATABASE_FAILURE
데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_DATABASE_FULL
데이터베이스가 가득 찼습니다.
ERROR_INVALID_HANDLE
세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_MEDIA
미디어 ID 중 하나 이상이 잘못되었습니다.
ERROR_INVALID_MEDIA_POOL
논리 미디어에 대한 하나 이상의 미디어 풀이 잘못되었습니다.
ERROR_INVALID_PARAMETER
하나 이상의 미디어 식별자가 없습니다.
ERROR_NOT_ENOUGH_MEMORY
처리하는 동안 할당 오류가 발생했습니다.
ERROR_SUCCESS
함수가 성공했습니다.

설명

SwapNtmsMedia 함수는 애플리케이션에 영향을 주지 않고 물리적 미디어를 업데이트하는 데 사용됩니다.

이 함수가 성공하려면 두 LMID의 미디어를 사용해서는 안 됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ntmsapi.h
라이브러리 Ntmsapi.lib
DLL Ntmsapi.dll

추가 정보

AllocateNtmsMedia

Media Services 함수