Funzione GetNtmsObjectAttributeA (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La funzione GetNtmsObjectAttribute recupera l'attributo esteso (denominato dati privati) 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 alla 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 di tipi di oggetti, 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 input, in byte. In output, le dimensioni effettive dei dati, in byte.
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. |
|
Query del database o aggiornamento non riuscito. |
|
Le dimensioni del buffer non sono specificate correttamente. La dimensione corretta viene restituita nel parametro lpAttributeSize . |
|
Il valore specificato nel parametro hSession è NULL o non è valido. |
|
Il puntatore è NULL o non è valido. |
|
Impossibile connettersi al servizio RSM. |
|
L'attributo specificato non è stato trovato. |
|
La funzione ha avuto esito positivo. |
Commenti
La funzione GetNtmsObjectAttribute deve essere eseguita nel server RSM. Poiché il buffer di byte non è visibile tra sistemi di architetture diverse, l'esecuzione remota di questa funzione può causare risultati imprevedibili.
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_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 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 GetNtmsObjectAttribute 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 |