DeleteNtmsMedia 함수(ntmsapi.h)

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

DeleteNtmsMedia 함수는 데이터베이스에서 지정된 미디어에 대한 모든 참조를 제거하여 RSM에서 오프라인 미디어의 실제 부분을 삭제합니다.

구문

DWORD DeleteNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

[in] hSession

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

[in] lpMediaId

물리적 미디어 조각의 고유 식별자입니다.

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

값	의미
ERROR_ACCESS_DENIED	컴퓨터 또는 미디어의 미디어 풀에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다. Windows XP: 미디어의 미디어 풀에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
ERROR_DATABASE_FAILURE	데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_DATABASE_FULL	데이터베이스가 가득 찼습니다.
ERROR_INVALID_HANDLE	세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_MEDIA	미디어 식별자가 잘못되었습니다.
ERROR_INVALID_MEDIA_POOL	미디어의 미디어 풀이 잘못되었습니다.
ERROR_INVALID_PARAMETER	미디어 식별자가 없습니다.
ERROR_INVALID_STATE	미디어가 오프라인 상태가 아닙니다.
ERROR_NOT_ENOUGH_MEMORY	처리하는 동안 할당 오류가 발생했습니다.
ERROR_SUCCESS	함수가 성공했습니다.

DeleteNtmsMedia 함수로 지정된 미디어는 오프라인 라이브러리에 있어야 하며 할당됨, 완료됨 또는 예약됨 상태의 측면이 없어야 합니다.

DeleteNtmsMedia를 사용하여 손실되거나 파괴된 미디어를 제거할 수 있습니다.