DeallocateNtmsMedia 함수(ntmsapi.h)

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

DeallocateNtmsMedia 함수는 지정된 논리 미디어와 연결된 쪽의 할당을 취소합니다.

구문

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

매개 변수

[in] hSession

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

[in] lpMediaId

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

dwOptions

예약; 는 0이어야 합니다.

반환 값

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

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

설명

논리 매체가 DeallocateNtmsMedia 함수와 할당 취소되면 RSM은 논리 미디어와 연결된 쪽을 사용 가능 또는 서비스 해제된 미디어 상태에 배치합니다. 논리 미디어의 할당이 취소되면 논리 미디어가 시스템에서 삭제됩니다.

측면이 미디어 풀에 지정된 최대 횟수만큼 할당된 경우 측면은 할당 취소 시 해제됩니다. 미디어가 서비스 해제 상태이면 다시 할당할 수 없습니다.

Windows Server 2003: 미디어가 무료 풀로 반환되는 경우 무료 풀로 NTMS_USE_ACCESS 원본 풀에 NTMS_CONTROL_ACCESS 필요합니다. 무료 풀이 대상 미디어 풀이 아닌 경우 원본 풀과 대상 풀 모두에서 NTMS_CONTROL_ACCESS 필요합니다.

요구 사항

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

추가 정보

AllocateNtmsMedia

Media Services 함수