ReserveNtmsCleanerSlot-Funktion (ntmsapi.h)
[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Die ReserveNtmsCleanerSlot-Funktion reserviert einen einzelnen Steckplatz in einer Bibliothekseinheit für eine Laufwerksreinigerpatrone.
Syntax
DWORD ReserveNtmsCleanerSlot(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpLibrary,
[in] LPNTMS_GUID lpSlot
);
Parameter
[in] hSession
Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.
[in] lpLibrary
Eindeutiger Bezeichner der Bibliothek, um den saubereren Slot zu reservieren.
[in] lpSlot
Eindeutiger Bezeichner des Steckplatzes, der für eine sauberere Patrone reserviert werden soll.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. |
|
Entweder dieser Slot oder ein anderer Slot in der Bibliothek wurde bereits für die Reinigung reserviert. Um den Slot der Saubererpatrone zu ändern, muss der derzeit reservierte Reinigungsslot-Slot zuerst mit der ReleaseNtmsCleanerSlot-Funktion freigegeben werden. |
|
Die Bibliothek ist derzeit nicht verbunden. |
|
Der im hSession-Parameter angegebene Wert ist ungültig. |
|
Die Slotdefinition kann nicht aus der Datenbank abgerufen werden. |
|
Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden. |
|
Ein saubererer Steckplatz ist nicht reserviert. Der angegebene Slot enthält Medien. Reservierungen können nur für einen leeren Slot ausgeführt werden. |
|
Ein saubererer Steckplatz ist nicht reserviert. Der angegebene Slot ist derzeit nicht in der Bibliothek installiert. Dieser Fehler tritt auf, wenn mindestens ein Patronenmagazin in der Bibliothek fehlt. |
|
Die Funktion wurde erfolgreich in die Warteschlange gestellt. |
Hinweise
Der mit der ReserveNtmsCleanerSlot-Funktion reservierte Slot muss vorhanden und leer sein. Die Bibliothek darf nicht bereits über einen Slot verfügen, der für eine sauberere Patrone reserviert ist.
Anforderungen
| 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 |