Freigeben über

SetNtmsObjectInformationW-Funktion (ntmsapi.h)

  • Artikel

[Wechselmedien-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 SetNtmsObjectInformationW(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONW lpInfo
);

Parameter

[in] hSession

Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.

[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 geschriebenen Objekt verweigert wird oder keine Änderungen an dem angegebenen Objekttyp zulässig sind. Siehe Anmerkungen.
ERROR_SUCCESS
 Die Funktion war erfolgreich.
ERROR_DATABASE_FAILURE
 Auf die Datenbank kann nicht zugegriffen oder beschädigt werden.
ERROR_DATABASE_FULL
 Die Datenbank ist voll.
ERROR_INVALID_HANDLE
 Der 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.

Bemerkungen

Die Informationsgröße und der Informationstyp müssen festgelegt werden, bevor Sie SetNtmsObjectInformationverwenden können.

Alle beschreibbaren Eigenschaften für das Objekt werden aus der NTMS_OBJECTINFORMATION-Struktur gelesen und ohne Rücksicht auf Schreibvorgänge in die Datenbank geschrieben, die zwischen dem Zeitpunkt, zu dem diese Anwendung die GetNtmsObjectInformation-Funktion aufgerufen hat, und die SetNtmsObjectInformation-Funktion. Aus diesem Gründen können Sie Änderungen verlieren.

Um unvorhersehbare Ergebnisse zu vermeiden, müssen Anwendungen GetNtmsObjectInformation- aufrufen, bevor SetNtmsObjectInformationaufgerufen 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 mit Elementen, die aktualisiert werden können.

Objekt Angehörige
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 AutoWiederherstellen-
 
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 für den 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 für den 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 für den Medienpool der Seite.

Windows XP: Erfordert NTMS_CONTROL_ACCESS für den 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.
 

Anmerkung

Der ntmsapi.h-Header definiert SetNtmsObjectInformation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- ntmsapi.h
Library Ntmsapi.lib
DLL- Ntmsapi.dll

Siehe auch

GetNtmsObjectInformation-

GetNtmsObjectSecurity-

NTMS_OBJECTINFORMATION

Objektverwaltungsfunktionen