Funzione GetNtmsObjectInformationW (ntmsapi.h)

Articolo
11/20/2024

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

La funzione GetNtmsObjectInformation restituisce la struttura di 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 per la 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. Sono anche possibili altri errori di sicurezza, ma indicano un errore del sottosistema di sicurezza. Windows XP: Non sono necessari diritti di accesso.
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.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Osservazioni

Le dimensioni delle 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 di fornire un valore per tutti i membri scrivibili.

Di seguito è riportato l'elenco di oggetti che richiedono diritti di accesso speciali.

Oggetto	Accesso
NTMS_CHANGER	Richiede NTMS_USE_ACCESS alla libreria.
NTMS_CHANGER_TYPE	Richiede NTMS_USE_ACCESS al computer.
NTMS_COMPUTER	Richiede NTMS_USE_ACCESS al computer.
NTMS_DRIVE	Richiede NTMS_USE_ACCESS alla libreria.
NTMS_DRIVE_TYPE	Richiede NTMS_USE_ACCESS al computer.
NTMS_IEDOOR	Richiede NTMS_USE_ACCESS alla libreria.
NTMS_IEPORT	Richiede NTMS_USE_ACCESS alla libreria.
NTMS_LIBRARY	Richiede NTMS_USE_ACCESS alla libreria.
NTMS_LIBREQUEST	Richiede NTMS_USE_ACCESS alla 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 di supporti del lato.
NTMS_PHYSICAL_MEDIA	Richiede NTMS_USE_ACCESS al pool di supporti.
NTMS_STORAGESLOT	Richiede NTMS_USE_ACCESS alla 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 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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funzioni di gestione oggetti

SetNtmsObjectInformation

Condividi tramite