Funzione GetNtmsObjectInformation (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La funzione GetNtmsObjectInformation restituisce la struttura delle informazioni di un oggetto per l'oggetto specificato.
Sintassi
DWORD GetNtmsObjectInformation(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[out] LPNTMS_OBJECTINFORMATION lpInfo
);
Parametri
[in] hSession
Handle alla sessione restituita dalla funzione OpenNtmsSession .
[in] lpObjectId
Identificatore univoco dell'oggetto RSM.
[out] lpInfo
Puntatore a una struttura NTMS_OBJECTINFORMATION che riceve le informazioni sull'oggetto.
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
NTMS_USE_ACCESS all'oggetto o al relativo contenitore viene negato. Altri errori di sicurezza sono anche possibili, ma indicano un errore del sottosistema di sicurezza.
Windows XP: Non sono necessari diritti di accesso. |
|
L'handle di sessione non è valido o non è valido. |
|
L'ID oggetto o la struttura delle informazioni non è valida oppure le informazioni sull'oggetto o il tipo di oggetto non sono validi. |
|
Si è verificato un errore di allocazione durante l'elaborazione. |
|
L'ID oggetto non è valido. |
|
La funzione ha avuto esito positivo. |
Commenti
Le informazioni e il tipo della struttura delle informazioni devono essere impostati correttamente nel parametro lpInfo prima di usare la funzione GetNtmsObjectInformation .
Per evitare risultati imprevedibili, le applicazioni devono chiamare la funzione GetNtmsObjectInformation prima di chiamare la funzione SetNtmsObjectInformation . La funzione SetNtmsObjectInformation aggiorna tutti i membri scrivibili della struttura NTMS_OBJECTINFORMATION , pertanto l'applicazione è responsabile della fornitura di un valore per tutti i membri scrivibili.
Di seguito è riportato l'elenco di oggetti che richiedono diritti di accesso speciali.
| Oggetto | Access |
|---|---|
| NTMS_CHANGER | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_CHANGER_TYPE | Richiede NTMS_USE_ACCESS al computer. |
| NTMS_COMPUTER | Richiede NTMS_USE_ACCESS al computer. |
| NTMS_DRIVE | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_DRIVE_TYPE | Richiede NTMS_USE_ACCESS al computer. |
| NTMS_IEDOOR | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_IEPORT | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_LIBRARY | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_LIBREQUEST | Richiede NTMS_USE_ACCESS nella libreria. |
| NTMS_LOGICAL_MEDIA | Richiede NTMS_USE_ACCESS al pool di supporti del supporto logico. |
| NTMS_MEDIA_TYPE | Richiede NTMS_USE_ACCESS al computer. |
| NTMS_OPREQUEST | Richiede NTMS_USE_ACCESS al computer. |
| NTMS_PARTITION | Richiede NTMS_USE_ACCESS al pool multimediale del lato. |
| NTMS_PHYSICAL_MEDIA | Richiede NTMS_USE_ACCESS al pool di supporti. |
| NTMS_STORAGESLOT | Richiede NTMS_USE_ACCESS nella libreria. |
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 |