次の方法で共有

NTMS_OBJECTINFORMATIONW構造体 (ntmsapi.h)

  • [アーティクル]

[Windows 7 および Windows Server 2008 R2 以降、リムーバブル 記憶域マネージャー は使用できなくなりました。

NTMS_OBJECTINFORMATION 構造体は、アプリケーションが RSM デバイス、メディア、およびシステム コントロール (ライブラリ、ドライブ、メディア、オペレーター要求など) に対して取得および設定できるプロパティを定義します。 これは、RSM データベース内のオブジェクトの一般的な構造です。

構文

typedef struct _NTMS_OBJECTINFORMATIONW {
  DWORD      dwSize;
  DWORD      dwType;
  SYSTEMTIME Created;
  SYSTEMTIME Modified;
  NTMS_GUID  ObjectGuid;
  BOOL       Enabled;
  DWORD      dwOperationalState;
  WCHAR      szName[NTMS_OBJECTNAME_LENGTH];
  WCHAR      szDescription[NTMS_DESCRIPTION_LENGTH];
#if ...
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#else
  union {
    NTMS_DRIVEINFORMATIONW       Drive;
    NTMS_DRIVETYPEINFORMATIONW   DriveType;
    NTMS_LIBRARYINFORMATION      Library;
    NTMS_CHANGERINFORMATIONW     Changer;
    NTMS_CHANGERTYPEINFORMATIONW ChangerType;
    NTMS_STORAGESLOTINFORMATION  StorageSlot;
    NTMS_IEDOORINFORMATION       IEDoor;
    NTMS_IEPORTINFORMATION       IEPort;
    NTMS_PMIDINFORMATIONW        PhysicalMedia;
    NTMS_LMIDINFORMATION         LogicalMedia;
    NTMS_PARTITIONINFORMATIONW   Partition;
    NTMS_MEDIAPOOLINFORMATION    MediaPool;
    NTMS_MEDIATYPEINFORMATION    MediaType;
    NTMS_LIBREQUESTINFORMATIONW  LibRequest;
    NTMS_OPREQUESTINFORMATIONW   OpRequest;
    NTMS_COMPUTERINFORMATION     Computer;
  } Info;
#endif
} NTMS_OBJECTINFORMATIONW, *LPNTMS_OBJECTINFORMATIONW;

メンバーズ

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
 物理メディア オブジェクトは、磁気テープまたはリムーバブル ディスクを表します。 物理メディアの一部には、1 つまたは複数の側面を含めることができます。 Info メンバーは、NTMS_PMIDINFORMATION 構造体へのポインターです。
NTMS_STORAGESLOT
 ストレージ スロット オブジェクトは、ライブラリ内の指定されたメディアを保持できるスロットの 1 つを表します。 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 ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてNTMS_OBJECTINFORMATIONを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー ntmsapi.h

関連項目

GetNtmsObjectInformation の

SetNtmsObjectInformation の