[可移除儲存管理器 自 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;
Members
dwSize
類型： DWORD
資訊結構的大小，以位元組為單位。 在使用 GetNtmsObjectInformation 函式或 SetNtmsObjectInformation 函式之前，必須先將此成員設定為結構體的正確大小。
dwType
類型： DWORD
用於取得或設定資訊的裝置或系統控制類型。 此成員必須設為以下其中一個值。
| 價值觀 | Meaning |
|---|---|
|
換紙器物件代表圖書館單元的機器人元素。 資訊成員是指向NTMS_CHANGERINFORMATION結構的指標。 |
|
每個連接到系統的獨特轉換器裝置類型都會建立一個切換器類型物件。 資訊成員是指向NTMS_CHANGERTYPEINFORMATION結構的指標。 |
|
目前的電腦物件。 電腦物件沒有結構。 資訊成員是指向NTMS_COMPUTERINFORMATION結構的指標。 |
|
磁碟機物件代表磁帶機或磁碟機。 資訊成員是指向NTMS_DRIVEINFORMATION結構的指標。 |
|
每個連接到系統的獨特磁碟裝置類型都會建立一個磁碟類型物件。 資訊成員是指向NTMS_DRIVETYPEINFORMATION結構的指標。 |
|
NTMS_IEDOOR物件代表圖書館單元的門禁機制。 資訊成員是指向NTMS_IEDOORINFORMATION結構的指標。 |
|
NTMS_IEPORT物件代表函式庫單元的插入/彈出埠。 資訊成員是指向NTMS_IEPORTINFORMATION結構的指標。 |
|
函式庫物件代表線上或離線函式庫。 資訊成員是指向NTMS_LIBRARYINFORMATION結構的指標。 |
|
每個函式庫執行動作的請求都會建立一個函式庫請求物件。 RSM 會維護一份函式庫請求清單，作為待執行工作的排隊。 資訊成員是指向NTMS_LIBREQUESTINFORMATION結構的指標。 |
|
應用程式用來存取指定媒介的主要帳號。 在多面媒體的情況下，每一面都被視為獨立的實體媒介。 資訊成員是指向NTMS_LMIDINFORMATION結構的指標。 |
|
媒體庫是媒體的合理組合。 媒體池中的所有媒體必須是相同的媒體類型。 資訊成員是指向NTMS_MEDIAPOOLINFORMATION結構的指標。 |
|
系統中每個獨特的媒體類型都會建立一個媒體類型物件。 資訊成員是指向NTMS_MEDIATYPEINFORMATION結構的指標。 |
|
運算子請求物件代表使用者取得資訊的 RSM 請求。 資訊成員是指向NTMS_OPREQUESTINFORMATION結構的指標。 |
|
側物件代表實體媒介的一面。 資訊成員是指向NTMS_PARTITIONINFORMATION結構的指標。 |
|
實體媒體物件代表磁帶或可拆卸磁碟。 一件實體媒介可以包含一面或多面。 資訊成員是指向NTMS_PMIDINFORMATION結構的指標。 |
|
儲存槽物件代表函式庫中可容納指定媒介的槽之一。 資訊成員是指向NTMS_STORAGESLOTINFORMATION結構的指標。 |
Created
類型： 系統時間
物件被建立的時間戳記。
Modified
類型： 系統時間
物件被修改的時間戳記。
ObjectGuid
類型： NTMS_GUID
物件的 GUID。
Enabled
類型： 布爾值
顯示裝置或系統控制物件是否已啟用。
dwOperationalState
類型： DWORD
定義物件目前的運作狀態。 這可以是下列其中一個值。
| 價值觀 | Meaning |
|---|---|
|
此裝置或物件目前不存在。 |
|
這個裝置或物件已經準備好了。 |
|
此裝置或物件故障，需要維修。 |
szName[NTMS_OBJECTNAME_LENGTH]
類型： TCHAR[NTMS_OBJECTNAME_LENGTH]
媒介、裝置或系統控制物件的名稱。 媒體池與邏輯媒體名稱可透過 SetNtmsObjectInformation 函式更改。 其他所有物件名稱皆為唯讀。
szDescription[NTMS_DESCRIPTION_LENGTH]
類型： TCHAR[NTMS_DESCRIPTION_LENGTH]
裝置或系統控制物件的描述。 裝置與系統控制物件的描述可透過 SetNtmsObjectInformation 函式進行變更。 （所有物件皆可書寫）
Info
裝置或系統控制物件專屬資訊。 此資訊的格式取決於 dwType 成員。
Info.Drive
當 dwType 值為 NTMS_DRIVE 時，會使用此格式。
Info.DriveType
當 dwType 值為 NTMS_DRIVE_TYPE 時，使用此格式。
Info.Library
當 dwType 值為 NTMS_LIBRARY 時，會使用此格式。
Info.Changer
當 dwType 值為 NTMS_CHANGER 時，會使用此格式。
Info.ChangerType
類型： NTMS_CHANGERTYPEINFORMATION
當 dwType 值為 NTMS_CHANGER_TYPE 時，使用此格式。
Info.StorageSlot
類型： NTMS_STORAGESLOTINFORMATION
當 dwType 值為 NTMS_STORAGESLOT 時，使用此格式。
Info.IEDoor
當 dwType 值為 NTMS_IEDOOR時，會使用此格式。
Info.IEPort
當 dwType 值為 NTMS_IEPORT 時，會使用此格式。
Info.PhysicalMedia
當 dwType 值為 NTMS_PHYSICAL_MEDIA 時，會使用此格式。
Info.LogicalMedia
當 dwType 值為 NTMS_LOGICAL_MEDIA 時，使用此格式。
Info.Partition
當 dwType 值為 NTMS_PARTITION 時，使用此格式。
Info.MediaPool
當 dwType 值為 NTMS_MEDIA_POOL 時，會使用此格式。
Info.MediaType
當 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 標頭將 NTMS_OBJECTINFORMATION 定義為別名，根據 UNICODE 預處理器常數的定義，自動選擇此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型 的慣例。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| Header | ntmsapi.h |