NTMS_OBJECTINFORMATIONA 구조체(ntmsapi.h)

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

NTMS_OBJECTINFORMATION 구조는 애플리케이션이 RSM 디바이스, 미디어 및 시스템 컨트롤(예: 라이브러리, 드라이브, 미디어, 운영자 요청)에 대해 가져와서 설정할 수 있는 속성을 정의합니다. RSM 데이터베이스에 있는 개체의 일반적인 구조입니다.

통사론

typedef struct _NTMS_OBJECTINFORMATIONA {
  DWORD      dwSize;
  DWORD      dwType;
  SYSTEMTIME Created;
  SYSTEMTIME Modified;
  NTMS_GUID  ObjectGuid;
  BOOL       Enabled;
  DWORD      dwOperationalState;
  CHAR       szName[NTMS_OBJECTNAME_LENGTH];
  CHAR       szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
  union {
    NTMS_DRIVEINFORMATIONA       Drive;
    NTMS_DRIVETYPEINFORMATIONA   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONA     Changer;
    NTMS_CHANGERTYPEINFORMATIONA ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONA        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONA   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONA  LibRequest;
    NTMS_OPREQUESTINFORMATIONA   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#else
  union {
    NTMS_DRIVEINFORMATIONA       Drive;
    NTMS_DRIVETYPEINFORMATIONA   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONA     Changer;
    NTMS_CHANGERTYPEINFORMATIONA ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONA        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONA   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONA  LibRequest;
    NTMS_OPREQUESTINFORMATIONA   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#endif
} NTMS_OBJECTINFORMATIONA, *LPNTMS_OBJECTINFORMATIONA;

회원

dwSize

형식: DWORD

정보 구조의 크기(바이트)입니다. 이 멤버는 GetNtmsObjectInformation 함수 또는 SetNtmsObjectInformation 함수를 사용하기 전에 구조체의 올바른 크기로 설정해야 합니다.

dwType

형식: DWORD

정보를 얻거나 설정할 디바이스 또는 시스템 컨트롤의 유형입니다. 이 멤버는 다음 값 중 하나로 설정해야 합니다.

값	의미
NTMS_CHANGER	체인저 개체는 라이브러리 단위의 로봇 요소를 나타냅니다. Info 멤버는 NTMS_CHANGERINFORMATION 구조체에 대한 포인터입니다.
NTMS_CHANGER_TYPE	시스템에 연결된 각 고유한 체인저 디바이스 유형에 대해 체인저 유형 개체가 만들어집니다. Info 멤버는 NTMS_CHANGERTYPEINFORMATION 구조체에 대한 포인터입니다.
NTMS_COMPUTER	현재 컴퓨터 개체입니다. 컴퓨터 개체에 대한 구조가 없습니다. Info 멤버는 NTMS_COMPUTERINFORMATION 구조체에 대한 포인터입니다.
NTMS_DRIVE	드라이브 개체는 테이프 드라이브 또는 디스크 드라이브를 나타냅니다. Info 멤버는 NTMS_DRIVEINFORMATION 구조체에 대한 포인터입니다.
NTMS_DRIVE_TYPE	드라이브 유형 개체는 시스템에 연결된 각 고유한 드라이브 디바이스 유형에 대해 만들어집니다. Info 멤버는 NTMS_DRIVETYPEINFORMATION 구조체에 대한 포인터입니다.
NTMS_IEDOOR	NTMS_IEDOOR 개체는 라이브러리 단위의 문 액세스 메커니즘을 나타냅니다. Info 멤버는 NTMS_IEDOORINFORMATION 구조체에 대한 포인터입니다.
NTMS_IEPORT	NTMS_IEPORT 개체는 라이브러리 단위의 삽입/배출 포트를 나타냅니다. Info 멤버는 NTMS_IEPORTINFORMATION 구조체에 대한 포인터입니다.
NTMS_LIBRARY	라이브러리 개체는 온라인 또는 오프라인 라이브러리를 나타냅니다. Info 멤버는 NTMS_LIBRARYINFORMATION 구조체에 대한 포인터입니다.
NTMS_LIBREQUEST	라이브러리가 작업을 수행하기 위한 각 요청에 대해 라이브러리 요청 개체가 만들어집니다. 라이브러리 요청 목록은 RSM에서 수행할 작업 큐로 유지 관리됩니다. Info 멤버는 NTMS_LIBREQUESTINFORMATION 구조체에 대한 포인터입니다.
NTMS_LOGICAL_MEDIA	애플리케이션에서 지정된 매체에 액세스하는 데 사용하는 기본 핸들입니다. 다면 미디어의 경우 각 면은 개별 물리적 미디어로 처리됩니다. Info 멤버는 NTMS_LMIDINFORMATION 구조체에 대한 포인터입니다.
NTMS_MEDIA_POOL	미디어 풀은 미디어의 논리적 그룹화입니다. 미디어 풀의 모든 미디어는 동일한 미디어 형식이어야 합니다. Info 멤버는 NTMS_MEDIAPOOLINFORMATION 구조체에 대한 포인터입니다.
NTMS_MEDIA_TYPE	시스템의 각 고유한 미디어 형식에 대해 미디어 형식 개체가 만들어집니다. Info 멤버는 NTMS_MEDIATYPEINFORMATION 구조체에 대한 포인터입니다.
NTMS_OPREQUEST	운영자 요청 개체는 사용자가 정보를 가져오기 위한 RSM 요청을 나타냅니다. Info 멤버는 NTMS_OPREQUESTINFORMATION 구조체에 대한 포인터입니다.
NTMS_PARTITION	측면 개체는 물리적 미디어 부분의 측면을 나타냅니다. Info 멤버는 NTMS_PARTITIONINFORMATION 구조체에 대한 포인터입니다.
NTMS_PHYSICAL_MEDIA	물리적 미디어 개체는 자기 테이프 또는 이동식 디스크를 나타냅니다. 물리적 미디어에는 하나 이상의 면이 포함될 수 있습니다. Info 멤버는 NTMS_PMIDINFORMATION 구조체에 대한 포인터입니다.
NTMS_STORAGESLOT	스토리지 슬롯 개체는 라이브러리에 지정된 매체를 보관할 수 있는 슬롯 중 하나를 나타냅니다. Info 멤버는 NTMS_STORAGESLOTINFORMATION 구조체에 대한 포인터입니다.

Created

형식: SYSTEMTIME

개체를 만든 날짜/타임스탬프를 지정합니다.

Modified

형식: SYSTEMTIME

개체가 수정된 날짜/타임스탬프를 지정합니다.

ObjectGuid

형식: NTMS_GUID

개체의 GUID입니다.

Enabled

형식: BOOL

디바이스 또는 시스템 제어 개체를 사용할 수 있는지 여부를 나타냅니다.

dwOperationalState

형식: DWORD

개체의 현재 작동 상태를 정의합니다. 다음 값 중 하나일 수 있습니다.

값	의미
NTMS_NOT_PRESENT	이 디바이스 또는 개체는 현재 존재하지 않습니다.
NTMS_READY	이 디바이스 또는 개체를 사용할 수 있고 준비되었습니다.
NTMS_NEEDS_SERVICE	이 디바이스 또는 개체가 실패했으며 서비스가 필요합니다.

szName[NTMS_OBJECTNAME_LENGTH]

형식: TCHAR[NTMS_OBJECTNAME_LENGTH]

미디어, 디바이스 또는 시스템 제어 개체의 이름입니다. SetNtmsObjectInformation 함수를 사용하여 미디어 풀 및 논리 미디어 이름을 변경할 수 있습니다. 다른 모든 개체 이름은 읽기 전용입니다.

szDescription[NTMS_DESCRIPTION_LENGTH]

형식: TCHAR[NTMS_DESCRIPTION_LENGTH]

디바이스 또는 시스템 제어 개체에 대한 설명입니다. SetNtmsObjectInformation 함수를 사용하여 디바이스 및 시스템 제어 개체에 대한 설명을 변경할 수 있습니다. (모든 개체에 대해 쓰기 가능)

Info

디바이스 또는 시스템 제어 개체 관련 정보입니다. 이 정보의 형식은 dwType 멤버에 따라 달라집니다.

Info.Drive

형식: NTMS_DRIVEINFORMATION 이 형식은 dwType 값이 NTMS_DRIVE경우에 사용됩니다.

Info.DriveType

형식: NTMS_DRIVETYPEINFORMATION 이 형식은 dwType 값이 NTMS_DRIVE_TYPE경우에 사용됩니다.

Info.Library

형식: NTMS_LIBRARYINFORMATION 이 형식은 dwType 값이 NTMS_LIBRARY경우에 사용됩니다.

Info.Changer

형식: NTMS_CHANGERINFORMATION 이 형식은 dwType 값이 NTMS_CHANGER경우에 사용됩니다.

Info.ChangerType

형식: NTMS_CHANGERTYPEINFORMATION 이 형식은 dwType 값이 NTMS_CHANGER_TYPE경우에 사용됩니다.

Info.StorageSlot

형식: NTMS_STORAGESLOTINFORMATION 이 형식은 dwType 값이 NTMS_STORAGESLOT경우에 사용됩니다.

Info.IEDoor

형식: NTMS_IEDOORINFORMATION 이 형식은 dwType 값이 NTMS_IEDOOR경우에 사용됩니다.

Info.IEPort

형식: NTMS_IEPORTINFORMATION 이 형식은 dwType 값이 NTMS_IEPORT경우에 사용됩니다.

Info.PhysicalMedia

형식: NTMS_PMIDINFORMATION 이 형식은 dwType 값이 NTMS_PHYSICAL_MEDIA경우에 사용됩니다.

Info.LogicalMedia

형식: NTMS_LMIDINFORMATION 이 형식은 dwType 값이 NTMS_LOGICAL_MEDIA경우에 사용됩니다.

Info.Partition

형식: NTMS_PARTITIONINFORMATION 이 형식은 dwType 값이 NTMS_PARTITION경우에 사용됩니다.

Info.MediaPool

형식: NTMS_MEDIAPOOLINFORMATION 이 형식은 dwType 값이 NTMS_MEDIA_POOL경우에 사용됩니다.

Info.MediaType

형식: NTMS_MEDIATYPEINFORMATION 이 형식은 dwType 값이 NTMS_MEDIA_TYPE경우에 사용됩니다.

Info.LibRequest

형식: NTMS_LIBREQUESTINFORMATION 이 형식은 dwType 값이 NTMS_LIBREQUEST경우에 사용됩니다.

Info.OpRequest

형식: NTMS_OPREQUESTINFORMATION 이 형식은 dwType 값이 NTMS_OPREQUEST경우에 사용됩니다.

Info.Computer

발언

멤버 정의에서 WRITABLE로 지정하지 않는 한 NTMS_OBJECTINFORMATION 구조체의 모든 멤버는 RSM 함수 수준에서 읽기 전용입니다.

메모

ntmsapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 NTMS_OBJECTINFORMATION 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	ntmsapi.h

참고 항목

GetNtmsObjectInformation

SetNtmsObjectInformation