共用方式為

SetNtmsObjectInformationW 函式 （ntmsapi.h）

  • 發行項

[ 從 Windows 7 和 Windows Server 2008 R2 起，卸除式存儲設備管理員 已無法使用。]

SetNtmsObjectInformation 函式會變更指定物件的信息結構。

語法

DWORD SetNtmsObjectInformationW(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONW lpInfo
);

參數

[in] hSession

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

[in] lpObjectId

RSM 物件的唯一標識符。

[in] lpInfo

NTMS_OBJECTINFORMATION 結構的指標。

傳回值

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

價值 意義
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS或NTMS_CONTROL_ACCESS拒絕寫入的物件，或不允許修改指定的物件類型。 請參閱。
ERROR_SUCCESS
 函式成功。
ERROR_DATABASE_FAILURE
 資料庫無法存取或損毀。
ERROR_DATABASE_FULL
 資料庫已滿。
ERROR_INVALID_HANDLE
 會話句柄遺失或無效。
ERROR_INVALID_PARAMETER
 物件標識碼或信息結構遺失，或對象資訊大小或物件類型無效。
ERROR_NOT_ENOUGH_MEMORY
 處理期間發生配置失敗。
ERROR_OBJECT_NOT_FOUND
 物件標識碼無效。

言論

必須先設定資訊大小和類型，才能 SetNtmsObjectInformation。

物件的所有可寫入屬性都會從 NTMS_OBJECTINFORMATION 結構讀取並寫入資料庫，而不論此應用程式呼叫 GetNtmsObjectInformation 函式與 SetNtmsObjectInformation 函式之間發生的任何寫入作業。 因此，您可以遺失變更。

為了避免無法預期的結果，應用程式必須先呼叫 getNtmsObjectInformation ，才能呼叫 setNtmsObjectInformation。 如上所述，SetNtmsObjectInformation 更新所有可寫入的成員，因此應用程式會負責為所有可寫入成員提供值。

以下是具有可更新之成員的物件清單。

物件 成員
NTMS_CHANGER szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_CHANGER_TYPE szDescription 需要NTMS_MODIFY_ACCESS電腦。

Windows XP： 不需要訪問許可權。
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription 需要NTMS_MODIFY_ACCESS電腦。

Windows XP： 不需要訪問許可權。
NTMS_DRIVE dwDeferDismountDelay
 
szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_DRIVE_TYPE szDescription 需要NTMS_MODIFY_ACCESS電腦。

Windows XP： 不需要訪問許可權。
NTMS_IEDOOR MaxOpenSecs
 
szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_IEPORT MaxExtendSecs
 
szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_LIBRARY 自動回復
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName 需要連結庫NTMS_CONTROL_ACCESS。
NTMS_LIBREQUEST szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_LOGICAL_MEDIA szDescription
 
szName 需要NTMS_MODIFY_ACCESS邏輯媒體的媒體集區。

Windows XP： 不需要訪問許可權。
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName 需要媒體集區NTMS_MODIFY_ACCESS。

Windows XP： 需要媒體集區NTMS_CONTROL_ACCESS。
NTMS_MEDIA_TYPE szDescription 需要NTMS_MODIFY_ACCESS電腦。

Windows XP： 不需要訪問許可權。
NTMS_OPREQUEST szDescription 需要NTMS_MODIFY_ACCESS電腦。

Windows XP： 不需要訪問許可權。
NTMS_PARTITION szName
 
szDescription 需要NTMS_MODIFY_ACCESS到側邊的媒體集區。

Windows XP： 需要NTMS_CONTROL_ACCESS到側邊的媒體集區。
NTMS_PHYSICAL_MEDIA szDescription
 
szName 需要媒體集區NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
NTMS_STORAGESLOT szDescription 需要連結庫NTMS_MODIFY_ACCESS。

Windows XP： 不需要訪問許可權。
 

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 ntmsapi.h
連結庫 Ntmsapi.lib
DLL Ntmsapi.dll

另請參閱

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

物件管理函式