AccessNtmsLibraryDoor 함수(ntmsapi.h)

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

AccessNtmsLibraryDoor 함수는 지정된 라이브러리의 문을 잠금 해제합니다. 라이브러리가 사용 중인 경우 RSM은 요청을 큐에 대기하고 성공적으로 반환합니다.

구문

DWORD AccessNtmsLibraryDoor(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

[in] hSession

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

[in] lpLibraryId

라이브러리 개체의 고유 식별자입니다. 이 라이브러리는 문 액세스를 지원해야 합니다.

[in] dwAction

수행할 작업입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
NTMS_INVENTORY_NONE	사용자가 문을 닫은 후에는 인벤토리가 수행되지 않습니다. 그러나 탑재 레이블 검사 실패하면 인벤토리가 수행됩니다.
NTMS_INVENTORY_OMID	사용자가 문을 닫으면 전체 온-미디어 인벤토리가 수행됩니다. 각 매체의 각 측면을 탑재해야 하므로 시간이 오래 걸릴 수 있습니다.
NTMS_INVENTORY_FAST	라이브러리에 바코드 판독기가 설치된 경우 이 플래그를 사용하면 바코드 인벤토리가 수행됩니다. 라이브러리에 바코드 판독기가 없는 경우 이 플래그로 인해 차등 인벤토리가 수행됩니다. 문이 열려 있는 동안 빈 슬롯에 배치된 각 매체에서 OID를 확인합니다.
NTMS_INVENTORY_DEFAULT	라이브러리 개체에 지정된 InventoryMethod 를 사용합니다( NTMS_LIBRARYINFORMATION 참조).

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

값	의미
ERROR_ACCESS_DENIED	라이브러리에 대한 NTMS_CONTROL_ACCESS 거부되었습니다. 다른 보안 오류도 가능하지만 보안 하위 시스템 오류를 나타냅니다.
ERROR_DATABASE_FAILURE	데이터베이스에 액세스할 수 없거나 손상되었습니다.
ERROR_DATABASE_FULL	데이터베이스가 가득 찼습니다.
ERROR_INVALID_HANDLE	세션 ID가 없거나 유효하지 않습니다.
ERROR_INVALID_PARAMETER	라이브러리 ID가 없습니다.
ERROR_LIBRARY_OFFLINE	라이브러리 ID는 문 없이 오프라인 라이브러리를 참조합니다.
ERROR_NOT_ENOUGH_MEMORY	처리하는 동안 할당 오류가 발생했습니다.
ERROR_RESOURCE_DISABLED	라이브러리를 사용할 수 없습니다.
ERROR_RESOURCE_NOT_PRESENT	라이브러리에 문이 없습니다.
ERROR_SUCCESS	문 액세스가 대기 중입니다.

일부 라이브러리는 RSM이 프로그래밍 방식으로 문을 잠그고 잠금을 해제할 수 있는 수단을 제공하지 않습니다. 이러한 라이브러리를 사용하는 이 함수의 동작은 RSM이 잠금을 해제하고 잠글 수 있는 라이브러리의 동작과 동일합니다.