Funzione GetNtmsObjectAttributeA (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 GetNtmsObjectAttribute recupera l'attributo esteso (dati privati denominati) dall'oggetto RSM specificato.

Sintassi

DWORD GetNtmsObjectAttributeA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpObjectId,
  [in]      DWORD       dwType,
  [in]      LPCSTR      lpAttributeName,
  [out]     LPVOID      lpAttributeData,
  [in, out] LPDWORD     lpAttributeSize
);

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] lpObjectId

Identificatore univoco dell'oggetto da cui recuperare i dati.

[in] dwType

Tipo di oggetto RSM. Per un elenco dei tipi di oggetto, vedere NtmsObjectsTypes.

[in] lpAttributeName

Nome dell'attributo esteso i cui dati devono essere recuperati.

[out] lpAttributeData

Puntatore al buffer che riceve i dati.

[in, out] lpAttributeSize

Dimensioni del buffer di dati in byte di input. In output, le dimensioni effettive dei dati, in byte.

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_DATABASE_FAILURE	La query o l'aggiornamento del database non è riuscito.
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer non sono specificate correttamente. La dimensione corretta viene restituita nel parametro lpAttributeSize.
ERROR_INVALID_HANDLE	Il valore specificato nel parametro hSession è NULL o non è valido.
ERROR_INVALID_PARAMETER	Il puntatore è NULL o non è valido.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_OBJECT_NOT_FOUND	Impossibile trovare l'attributo specificato.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Osservazioni

La funzione GetNtmsObjectAttribute deve essere eseguita nel server RSM. Poiché il buffer di byte non è stato unito tra sistemi di architetture diverse, l'esecuzione remota di questa funzione può comportare risultati imprevedibili.

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_POOL	Richiede NTMS_USE_ACCESS al pool di supporti.
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 GetNtmsObjectAttribute 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

EnumerateNtmsObject

Funzioni di gestione oggetti

SetNtmsObjectAttribute

Condividi tramite