Funzione EnableNtmsObject (ntmsapi.h)

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

La funzione EnableNtmsObject abilita l'oggetto specificato.

Sintassi

DWORD EnableNtmsObject(
  [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 del disco magnetico)

[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
L'ID oggetto è mancante 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à abilitato.
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
L'abilitazione viene accodata.

Commenti

La funzione EnableNtmsObject accoda un comando di disabilitazione con RSM. Se RSM è occupato, il comando può richiedere tempo per completare.

Requisiti

   
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

DisableNtmsObject

Funzioni di gestione oggetti