Funzione GetNtmsObjectInformationW (ntmsapi.h)

Articolo
02/29/2024

[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 GetNtmsObjectInformationW(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONW 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
ERROR_ACCESS_DENIED	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.
ERROR_INVALID_HANDLE	L'handle di sessione non è valido o non è valido.
ERROR_INVALID_PARAMETER	L'ID oggetto o la struttura delle informazioni non è valida 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.
ERROR_SUCCESS	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.

Nota

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

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funzioni di gestione oggetti

SetNtmsObjectInformation

Condividi tramite