Funzione SetNtmsObjectInformationA (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 SetNtmsObjectInformationA(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONA 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 di supporti del lato.

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

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

Windows XP: Non sono necessari diritti di accesso.
 

Nota

L'intestazione ntmsapi.h definisce SetNtmsObjectInformation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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