CleanNtmsDrive 함수(ntmsapi.h)

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

CleanNtmsDrive 함수는 정리를 위해 지정된 드라이브에 대한 정리 요청을 큐에 대기합니다.

구문

DWORD CleanNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

[in] hSession

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

[in] lpDriveId

정리할 드라이브의 고유 식별자입니다.

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

값	의미
ERROR_ACCESS_DENIED	라이브러리에 대한 NTMS_CONTROL_ACCESS 거부됩니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
ERROR_DATABASE_FAILURE	데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_DATABASE_FULL	데이터베이스가 가득 찼습니다.
ERROR_INVALID_DRIVE	드라이브 ID가 잘못되었습니다.
ERROR_INVALID_HANDLE	세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_LIBRARY	드라이브에 대한 라이브러리가 잘못되었습니다.
ERROR_INVALID_PARAMETER	드라이브 ID가 없습니다.
ERROR_NOT_ENOUGH_MEMORY	처리하는 동안 할당 오류가 발생했습니다.
ERROR_RESOURCE_DISABLED	드라이브 또는 라이브러리를 사용할 수 없습니다.
ERROR_SUCCESS	청소가 성공적으로 대기되었습니다.

CleanNtmsDrive 함수에서 선택한 드라이브가 독립 실행형 드라이브인 경우 드라이브는 정리된 것으로 표시되고 RSM 데이터베이스에 시간이 기록됩니다.

서비스가 다시 시작될 때 대기 중인 정리 요청이 삭제됩니다.