DisableNtmsObject 함수(ntmsapi.h)

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

DisableNtmsObject 함수는 지정된 RSM 개체를 사용하지 않도록 설정합니다.

구문

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

매개 변수

[in] hSession

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

[in] dwType

RSM 개체 형식입니다. 이 매개 변수는 NtmsObjectsTypes 열거형 형식의 다음 값 중 하나일 수 있습니다.

값	의미
NTMS_DRIVE	드라이브
NTMS_LIBRARY	라이브러리
NTMS_PHYSICAL_MEDIA	물리적 미디어(테이프, 광학 디스크, CD 또는 자기 카트리지)

[in] lpObjectId

RSM 개체의 고유 식별자입니다.

반환 값

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

값	의미
ERROR_ACCESS_DENIED	개체가 포함된 라이브러리에 대한 NTMS_MODIFY_ACCESS 거부됩니다. 다른 보안 오류가 발생할 수 있지만 보안 하위 시스템 오류를 나타냅니다. Windows XP: 개체가 포함된 라이브러리에 대한 NTMS_CONTROL_ACCESS 거부됩니다. 다른 보안 오류가 발생할 수 있지만 보안 하위 시스템 오류를 나타냅니다.
ERROR_DATABASE_FAILURE	데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_INVALID_HANDLE	세션 핸들이 없거나 잘못되었습니다.
ERROR_INVALID_PARAMETER	개체 ID가 없거나 개체 형식이 잘못되었습니다. 개체 형식이 NTMS_LIBRARY, NTMS_DRIVE 또는 NTMS_PHYSICAL_MEDIA 않으면 유효하지 않습니다.
ERROR_INVALID_STATE	개체가 이미 비활성화되어 있습니다.
ERROR_LIBRARY_OFFLINE	라이브러리 ID는 사용하거나 사용하지 않도록 설정할 수 없는 오프라인 라이브러리를 나타냅니다.
ERROR_OBJECT_NOT_FOUND	개체가 잘못되었습니다.
ERROR_SUCCESS	사용 안 함이 큐에 대기 중입니다.

설명

DisableNtmsObject 함수는 지정된 개체에 대해 disable 명령을 큐에 대기합니다. 명령이 큐에 대기되면 함수가 성공적으로 반환됩니다. RSM이 사용 중인 경우 명령을 완료하는 데 다소 시간이 걸릴 수 있습니다. 미디어를 사용하지 않도록 설정하면 RSM은 미디어의 모든 측면을 렌더링하고 연결된 논리 미디어를 사용할 수 없게 만듭니다. 비활성화된 미디어에 대한 모든 요청은 오류를 반환합니다.

서비스에서 드라이브 또는 미디어 체인저를 제거하려면 먼저 드라이브 또는 미디어 체인저를 사용하지 않도록 설정해야 합니다.

비활성화된 개체에 포함된 모든 개체도 사용하지 않도록 설정됩니다. 예를 들어 물리적 미디어를 사용하지 않도록 설정하면 모든 면이 비활성화됩니다. 가능하면 드라이브를 사용하지 않도록 설정하면 드라이브의 매체가 제거되어 슬롯에 배치됩니다.

요구 사항

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

추가 정보

EnableNtmsObject

개체 관리 함수