Condividi tramite

Funzione SetNtmsObjectInformationA (ntmsapi.h)

  • Articolo

[ di 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 scritto 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 è mancante oppure le informazioni sull'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.

Osservazioni

Prima di poter usare SetNtmsObjectInformation, è necessario impostare le dimensioni e il tipo di informazioni.

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 l'ora 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
 
DeallocationPolicy
 
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 sul 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione ntmsapi.h
libreria Ntmsapi.lib
dll Ntmsapi.dll

Vedere anche

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funzioni di gestione oggetti