Funzione SetNtmsObjectInformation (ntmsapi.h)

  • Articolo

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

La funzione SetNtmsObjectInformation modifica la struttura delle informazioni dell'oggetto specificato.

Sintassi

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

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto RSM.

[in] lpInfo

Puntatore a una struttura NTMS_OBJECTINFORMATION .

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore Significato
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS o NTMS_CONTROL_ACCESS viene negato all'oggetto in fase di scrittura o non sono consentite modifiche al tipo di oggetto specificato. Vedere la sezione Osservazioni.
ERROR_SUCCESS
 La funzione ha avuto esito positivo.
ERROR_DATABASE_FAILURE
 Il database non è accessibile o danneggiato.
ERROR_DATABASE_FULL
 Il database è pieno.
ERROR_INVALID_HANDLE
 L'handle di sessione è mancante o non è valido.
ERROR_INVALID_PARAMETER
 L'ID oggetto o la struttura delle informazioni non è presente oppure le dimensioni dell'oggetto o il tipo di oggetto non sono validi.
ERROR_NOT_ENOUGH_MEMORY
 Si è verificato un errore di allocazione durante l'elaborazione.
ERROR_OBJECT_NOT_FOUND
 L'ID oggetto non è valido.

Commenti

Le dimensioni e il tipo di informazioni devono essere impostati prima di poter usare SetNtmsObjectInformation.

Tutte le proprietà scrivibili per l'oggetto vengono lette dalla struttura NTMS_OBJECTINFORMATION e scritte nel database senza considerare le operazioni di scrittura che si sono verificate tra il momento in cui questa applicazione ha chiamato la funzione GetNtmsObjectInformation e la funzione SetNtmsObjectInformation . Per questo motivo è possibile perdere le modifiche.

Per evitare risultati imprevedibili, le applicazioni devono chiamare GetNtmsObjectInformation prima di chiamare SetNtmsObjectInformation. Come indicato in precedenza, SetNtmsObjectInformation aggiorna tutti i membri scrivibili, pertanto l'applicazione è responsabile di fornire un valore per tutti i membri scrivibili.

Di seguito è riportato l'elenco di oggetti con membri che possono essere aggiornati.

Oggetto Membri
NTMS_CHANGER szDescription Richiede NTMS_MODIFY_ACCESS alla libreria.

Windows XP: Non sono necessari diritti di accesso.
NTMS_CHANGER_TYPE szDescription Richiede NTMS_MODIFY_ACCESS al computer.

Windows XP: Non sono necessari diritti di accesso.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Richiede NTMS_MODIFY_ACCESS al computer.

Windows XP: Non sono necessari diritti di accesso.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Richiede NTMS_MODIFY_ACCESS alla libreria.

Windows XP: Non sono necessari diritti di accesso.
NTMS_DRIVE_TYPE szDescription Richiede NTMS_MODIFY_ACCESS al computer.

Windows XP: Non sono necessari diritti di accesso.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Richiede NTMS_MODIFY_ACCESS alla libreria.

Windows XP: Non sono necessari diritti di accesso.
NTMS_IEPORT MaxExtendSecs
 
szDescription Richiede NTMS_MODIFY_ACCESS alla libreria.

Windows XP: Non sono necessari diritti di accesso.
NTMS_LIBRARY Salvataggio automatico
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
Szname Richiede NTMS_CONTROL_ACCESS alla libreria.
NTMS_LIBREQUEST szDescription Richiede NTMS_MODIFY_ACCESS alla libreria.

Windows XP: Non sono necessari diritti di accesso.
NTMS_LOGICAL_MEDIA szDescription
 
Szname Richiede NTMS_MODIFY_ACCESS al pool di supporti del supporto logico.

Windows XP: Non sono necessari diritti di accesso.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocazionePolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
Szname Richiede NTMS_MODIFY_ACCESS al pool di supporti.

Windows XP: Richiede NTMS_CONTROL_ACCESS al pool di supporti.
NTMS_MEDIA_TYPE szDescription Richiede NTMS_MODIFY_ACCESS al computer.

Windows XP: Non sono necessari diritti di accesso.
NTMS_OPREQUEST szDescription Richiede NTMS_MODIFY_ACCESS al computer.

Windows XP: Non sono necessari diritti di accesso.
NTMS_PARTITION Szname
 
szDescription Richiede NTMS_MODIFY_ACCESS al pool multimediale del lato.

Windows XP: Richiede NTMS_CONTROL_ACCESS al pool multimediale del lato.
NTMS_PHYSICAL_MEDIA szDescription
 
Szname Richiede NTMS_MODIFY_ACCESS al pool multimediale.

Windows XP: Non sono necessari diritti di accesso.
NTMS_STORAGESLOT szDescription Richiede NTMS_MODIFY_ACCESS nella libreria.

Windows XP: Non sono necessari diritti di accesso.

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

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funzioni di gestione oggetti