SetNtmsMediaComplete 함수(ntmsapi.h)

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

SetNtmsMediaComplete 함수는 논리 미디어의 일부를 완료로 표시합니다.

구문

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

[in] hSession

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

[in] lpMediaId

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

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

값	의미
ERROR_ACCESS_DENIED	미디어의 미디어 풀에 대한 NTMS_CONTROL_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	함수가 성공했습니다.

SetNtmsMediaComplete 함수는 지정된 매체를 완료로 표시합니다. 애플리케이션이 더 이상 매체에 쓰지 않을 때 애플리케이션은 매체를 완료로 표시합니다. 전체 미디어를 NTMS_MOUNT_WRITE 플래그로 탑재할 수 없습니다.

SetNtmsMediaComplete 함수는 일반적으로 애플리케이션이 미디어 끝에 도달할 때 사용됩니다. 탑재되거나 사용 중인 미디어는 완료로 표시할 수 없습니다.