共用方式為

GetNtmsObjectAttributeA 函式 (ntmsapi.h)

  • 發行項

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

GetNtmsObjectAttribute 函式會從指定的 RSM 物件擷取名為 private data) 的擴充屬性 (。

語法

DWORD GetNtmsObjectAttributeA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpObjectId,
  [in]      DWORD       dwType,
  [in]      LPCSTR      lpAttributeName,
  [out]     LPVOID      lpAttributeData,
  [in, out] LPDWORD     lpAttributeSize
);

參數

[in] hSession

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

[in] lpObjectId

要從中擷取數據之物件的唯一標識碼。

[in] dwType

RSM 物件類型。 如需物件類型清單，請參閱 NtmsObjectsTypes。

[in] lpAttributeName

要擷取其數據之擴充屬性的名稱。

[out] lpAttributeData

接收數據的緩衝區指標。

[in, out] lpAttributeSize

輸入上的數據緩衝區大小，以位元組為單位。 輸出時，數據的實際大小，以位元組為單位。

傳回值

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

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

Windowsxp： 不需要任何訪問許可權。
ERROR_DATABASE_FAILURE
 資料庫查詢或更新失敗。
ERROR_INSUFFICIENT_BUFFER
 未正確指定緩衝區大小。 正確的大小會在 lpAttributeSize 參數中傳回。
ERROR_INVALID_HANDLE
 hSession 參數中指定的值為 NULL 或無效。
ERROR_INVALID_PARAMETER
 指標為 NULL 或無效。
ERROR_NOT_CONNECTED
 無法連線到 RSM 服務。
ERROR_OBJECT_NOT_FOUND
 找不到指定的屬性。
ERROR_SUCCESS
 函式成功。

備註

GetNtmsObjectAttribute 函式必須在 RSM 伺服器上執行。 由於不同架構系統之間未封存位元組的緩衝區，因此遠端執行此函式可能會導致無法預期的結果。

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

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_POOL 需要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。
 

注意

ntmsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetNtmsObjectAttribute 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

EnumerateNtmsObject

物件管理函式

SetNtmsObjectAttribute