Funzione UpdateNtmsOmidInfo (ntmsapi.h)

Articolo
03/09/2024

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

La funzione UpdateNtmsOmidInfo aggiorna il database RSM con le informazioni sull'etichetta immediatamente dopo la scrittura nel supporto appena allocato.

Sintassi

DWORD UpdateNtmsOmidInfo(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       labelType,
  [in] DWORD       numberOfBytes,
  [in] LPVOID      lpBuffer
);

Parametri

[in] hSession

Handle alla sessione restituita dalla funzione OpenNtmsSession .

[in] lpMediaId

Identificatore univoco di un elemento multimediale logico.

[in] labelType

Tipo di etichetta. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
NTMS_OMID_TYPE_FILESYSTEM_INFO	Il parametro lpBuffer contiene una struttura NTMS_FILESYSTEM_INFO. Questo flag viene usato per i supporti che contengono file system.
NTMS_OMID_TYPE_RAW_LABEL	Il parametro lpBuffer contiene i byte non elaborati dell'etichetta dell'applicazione. Questo flag viene usato per i supporti che contengono etichette scritte dall'applicazione.

[in] numberOfBytes

Numero di byte inviati nel parametro lpBuffer .

[in] lpBuffer

Informazioni sull'etichetta. Il formato di questo parametro dipende dal valore del parametro labelType .

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	L'accesso a uno o più oggetti RSM viene negato.
ERROR_DATABASE_FAILURE	Query del database o aggiornamento non riuscito.
ERROR_INVALID_HANDLE	Il valore specificato nel parametro hSession non è valido.
ERROR_INVALID_MEDIA	Impossibile recuperare la definizione dei supporti logici dal database.
ERROR_INVALID_PARTITION	Impossibile recuperare la definizione lato dal database.
ERROR_INVALID_PARAMETER	Il parametro lpMediaId è NULL.
ERROR_NOT_CONNECTED	Impossibile connettersi al servizio RSM.
ERROR_SUCCESS	La funzione ha avuto esito positivo.

Commenti

L'applicazione aggiorna RSM con le informazioni fornite dalla funzione UpdateNtmsOmidInfo e RSM verifica le informazioni nel database. Le informazioni sull'etichetta vengono archiviate nel database RSM con il lato associato a questo LMID.

La funzione UpdateNtmsOmidInfo deve essere eseguita nel server RSM. L'esecuzione remota di questa funzione genera un errore.

Per il supporto nastro lpBuffer deve puntare a un buffer che contiene l'etichetta appena scritta sul nastro. I dati in questo buffer vengono passati direttamente al punto di ingresso ClaimMediaLabel di ogni MLL. Uno degli MLL installati deve riconoscere un'etichetta valida in questi dati.

Per i supporti con file system, lpBuffer deve essere un puntatore a un buffer contenente la struttura seguente:


typedef struct {
    WCHAR   FileSystemType[64];
    WCHAR   VolumeName[256];
    DWORD   SerialNumber;
} NTMS_FILESYSTEM_INFO;

RSM usa queste informazioni sul file system come OMID. Le utilità di formato (LDM, Explorer, format.com e così via) eseguono in modo efficace le stesse funzionalità di questa chiamata. Un'applicazione che esegue la formattazione o i formati personalizzati con un tipo di file system di terze parti deve solo chiamare UpdateNtmsOmidInfo per i supporti del file system.

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

Funzioni di gestione degli identificatori multimediali

Condividi tramite