共用方式為

GetNtmsObjectInformation 函式 (ntmsapi.h)

  • 發行項

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員 。]

GetNtmsObjectInformation 函式會傳回指定對象的信息結構。

語法

DWORD GetNtmsObjectInformation(
  [in]  HANDLE                   hSession,
  [in]  LPNTMS_GUID              lpObjectId,
  [out] LPNTMS_OBJECTINFORMATION lpInfo
);

參數

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] lpObjectId

RSM 物件的唯一標識符。

[out] lpInfo

接收對象資訊的 NTMS_OBJECTINFORMATION 結構的指標。

傳回值

此函式會傳回下列其中一個值。

值 意義
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS物件或其容器遭到拒絕。 其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。

Windowsxp： 不需要任何訪問許可權。
ERROR_INVALID_HANDLE
 會話句柄遺失或無效。
ERROR_INVALID_PARAMETER
 遺漏物件標識碼或信息結構，或對象資訊大小或物件類型無效。
ERROR_NOT_ENOUGH_MEMORY
 處理期間發生配置失敗。
ERROR_OBJECT_NOT_FOUND
 物件標識碼無效。
ERROR_SUCCESS
 函式成功。

備註

您必須先在 lpInfo 參數中正確設定資訊結構的資訊大小和類型，才能使用 GetNtmsObjectInformation 函式 。

若要避免無法預期的結果，應用程式必須先呼叫 GetNtmsObjectInformation 函式，才能呼叫 SetNtmsObjectInformation 函式 。 SetNtmsObjectInformation 函式會更新NTMS_OBJECTINFORMATION結構的所有可寫入成員，因此應用程式會負責為所有可寫入的成員提供值。

以下是需要特殊訪問許可權的物件清單。

Object Access
NTMS_CHANGER 需要連結庫NTMS_USE_ACCESS。
NTMS_CHANGER_TYPE 需要NTMS_USE_ACCESS計算機。
NTMS_COMPUTER 需要NTMS_USE_ACCESS計算機。
NTMS_DRIVE 需要連結庫NTMS_USE_ACCESS。
NTMS_DRIVE_TYPE 需要NTMS_USE_ACCESS計算機。
NTMS_IEDOOR 需要連結庫NTMS_USE_ACCESS。
NTMS_IEPORT 需要連結庫NTMS_USE_ACCESS。
NTMS_LIBRARY 需要連結庫NTMS_USE_ACCESS。
NTMS_LIBREQUEST 需要連結庫NTMS_USE_ACCESS。
NTMS_LOGICAL_MEDIA 需要NTMS_USE_ACCESS邏輯媒體的媒體集區。
NTMS_MEDIA_TYPE 需要NTMS_USE_ACCESS計算機。
NTMS_OPREQUEST 需要NTMS_USE_ACCESS計算機。
NTMS_PARTITION 需要NTMS_USE_ACCESS到側邊的媒體集區。
NTMS_PHYSICAL_MEDIA 需要NTMS_USE_ACCESS媒體集區。
NTMS_STORAGESLOT 需要連結庫NTMS_USE_ACCESS。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntmsapi.h
程式庫 Ntmsapi.lib
Dll Ntmsapi.dll

另請參閱

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

物件管理函式

SetNtmsObjectInformation