SetNtmsObjectInformation-Funktion (ntmsapi.h)

  • Artikel

[Wechseldatenträger-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die SetNtmsObjectInformation-Funktion ändert die Informationsstruktur des angegebenen Objekts.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpObjectId

Eindeutiger Bezeichner des RSM-Objekts.

[in] lpInfo

Zeiger auf eine NTMS_OBJECTINFORMATION-Struktur .

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS oder NTMS_CONTROL_ACCESS dem zu schreibenden Objekt verweigert wird oder keine Änderungen am angegebenen Objekttyp zulässig sind. Siehe Hinweise.
ERROR_SUCCESS
 Die Funktion war erfolgreich.
ERROR_DATABASE_FAILURE
 Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
ERROR_DATABASE_FULL
 Die Datenbank ist voll.
ERROR_INVALID_HANDLE
 Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER
 Die Objekt-ID oder Informationsstruktur fehlt, oder die Objektinformationsgröße oder der Objekttyp ist ungültig.
ERROR_NOT_ENOUGH_MEMORY
 Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_OBJECT_NOT_FOUND
 Die Objekt-ID ist ungültig.

Hinweise

Die Informationsgröße und der Typ müssen festgelegt werden, bevor Sie SetNtmsObjectInformation verwenden können.

Alle beschreibbaren Eigenschaften für das Objekt werden aus der NTMS_OBJECTINFORMATION-Struktur gelesen und in die Datenbank geschrieben, ohne dass Schreibvorgänge beachtet werden, die zwischen der GetNtmsObjectInformation-Funktion und der SetNtmsObjectInformation-Funktion dieser Anwendung aufgetreten sind. Aus diesem Fall können Sie Änderungen verlieren.

Um unvorhersehbare Ergebnisse zu vermeiden, müssen Anwendungen GetNtmsObjectInformation aufrufen, bevor SetNtmsObjectInformation aufgerufen wird. Wie oben erwähnt aktualisiert SetNtmsObjectInformation alle beschreibbaren Member, daher ist die Anwendung dafür verantwortlich, einen Wert für alle beschreibbaren Member bereitzustellen.

Im Folgenden finden Sie die Liste der Objekte, die Über Member verfügen, die aktualisiert werden können.

Object Member
NTMS_CHANGER szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_CHANGER_TYPE szDescription Erfordert NTMS_MODIFY_ACCESS auf dem Computer.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Erfordert NTMS_MODIFY_ACCESS auf dem Computer.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_DRIVE_TYPE szDescription Erfordert NTMS_MODIFY_ACCESS auf dem Computer.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_IEPORT MaxExtendSecs
 
szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_LIBRARY AutoRecovery
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
Szname Erfordert NTMS_CONTROL_ACCESS für die Bibliothek.
NTMS_LIBREQUEST szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_LOGICAL_MEDIA szDescription
 
Szname Erfordert NTMS_MODIFY_ACCESS zum Medienpool der logischen Medien.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
Mediatype
 
szDescription
 
Szname Erfordert NTMS_MODIFY_ACCESS für den Medienpool.

Windows XP: Erfordert NTMS_CONTROL_ACCESS zum Medienpool.
NTMS_MEDIA_TYPE szDescription Erfordert NTMS_MODIFY_ACCESS auf dem Computer.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_OPREQUEST szDescription Erfordert NTMS_MODIFY_ACCESS auf dem Computer.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_PARTITION szName
 
szDescription Erfordert NTMS_MODIFY_ACCESS zum Medienpool der Seite.

Windows XP: Erfordert NTMS_CONTROL_ACCESS zum Medienpool der Seite.
NTMS_PHYSICAL_MEDIA szDescription
 
Szname Erfordert NTMS_MODIFY_ACCESS für den Medienpool.

Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_STORAGESLOT szDescription Erfordert NTMS_MODIFY_ACCESS für die Bibliothek.

Windows XP: Es sind keine Zugriffsrechte erforderlich.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntmsapi.h
Bibliothek Ntmsapi.lib
DLL Ntmsapi.dll

Weitere Informationen

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Objektverwaltungsfunktionen