Funzione DisableNtmsObject (ntmsapi.h)

Articolo
02/29/2024

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione DisableNtmsObject disabilita l'oggetto RSM specificato.

Sintassi

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] dwType

Tipo di oggetto RSM. Questo parametro può essere uno dei valori seguenti dal tipo di enumerazione NtmsObjectsTypes .

Valore	Significato
NTMS_DRIVE	Unità
NTMS_LIBRARY	Libreria
NTMS_PHYSICAL_MEDIA	Supporti fisici (nastro, disco ottico, CD o cartuccia magnetica)

[in] lpObjectId

Identificatore univoco dell'oggetto RSM.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS alla libreria contenente l'oggetto viene negato. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza. Windows XP: NTMS_CONTROL_ACCESS alla libreria contenente l'oggetto viene negato. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza.
ERROR_DATABASE_FAILURE	Il database è inaccessibile o danneggiato.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER	Un ID oggetto manca o il tipo di oggetto non è valido. Il tipo di oggetto non è valido se non è NTMS_LIBRARY, NTMS_DRIVE o NTMS_PHYSICAL_MEDIA.
ERROR_INVALID_STATE	L'oggetto è già disabilitato.
ERROR_LIBRARY_OFFLINE	L'ID della libreria fa riferimento a una libreria off-line che non può essere abilitata o disabilitata.
ERROR_OBJECT_NOT_FOUND	L'oggetto non è valido.
ERROR_SUCCESS	La disabilitazione viene accodata.

Commenti

La funzione DisableNtmsObject accoda un comando di disabilitazione per l'oggetto specificato. La funzione restituisce correttamente quando il comando viene accodato. Se RSM è occupato, il comando può richiedere tempo per completare. Quando il supporto è disabilitato, RSM esegue il rendering di tutti i lati del supporto multimediale e dei supporti logici associati non disponibili. Tutte le richieste ai supporti disabilitati restituiscono errori.

Per rimuovere un'unità o un modificatore multimediale dal servizio, è necessario prima disabilitare l'unità o il modificatore multimediale.

Tutti gli oggetti contenuti da un oggetto disabilitato sono disabilitati. Ad esempio, la disabilitazione di un elemento multimediale fisico disabilita tutti i lati. Ogni volta che è possibile, quando un'unità è disabilitata, il supporto nell'unità viene rimosso e inserito nello slot.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll

Vedi anche

EnableNtmsObject

Funzioni di gestione oggetti

Condividi tramite