Funzione CreateNtmsMediaA (ntmsapi.h)
[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]
La funzione CreateNtmsMedia crea un PMID e un lato (o lati) per un nuovo supporto offline. Il supporto viene inserito nel pool di supporti specificato per lpPhysicalMedia.
Sintassi
DWORD CreateNtmsMediaA(
[in] HANDLE hSession,
[in] LPNTMS_OBJECTINFORMATIONA lpMedia,
[in] LPNTMS_OBJECTINFORMATIONA lpList,
[in] DWORD dwOptions
);
Parametri
[in] hSession
Handle per la sessione restituita dalla funzione OpenNtmsSession .
[in] lpMedia
Puntatore a una struttura NTMS_OBJECTINFORMATION contenente informazioni sul supporto da creare. Per una descrizione dei membri applicabili, vedere Osservazioni.
[in] lpList
Puntatore a una struttura NTMS_OBJECTINFORMATION che specifica la matrice di lati associati al supporto. Per una descrizione dei membri applicabili, vedere Osservazioni.
[in] dwOptions
Opzioni. Questo parametro può avere uno dei valori seguenti.
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
NTMS_MODIFY_ACCESS al computer o al pool di supporti viene negato. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza.
Windows XP: NTMS_CONTROL_ACCESS al pool di supporti o NTMS_MODIFY_ACCESS alla libreria offline viene negata. Altri errori di sicurezza sono possibili, ma indicano un errore del sottosistema di sicurezza. |
|
Database inaccessibile o danneggiato. |
|
Il database è pieno. |
|
L'opzione NTMS_ERROR_ON_DUPLICATE è stata fornita e esiste già un supporto con questo OMID. |
|
L'handle di sessione è mancante o non è valido. |
|
Esiste già una voce per un supporto con questo codice a barre. |
|
Il pool di supporti specificato non esiste o non è un pool di applicazioni o di importazione valido. |
|
Parametro mancante oppure le dimensioni dell'oggetto o il tipo di oggetto non è valido. |
|
Il numero di lati specificati non corrisponde al numero di lati associati al tipo di supporto del pool di supporti. |
|
Errore di allocazione della memoria durante l'elaborazione. |
|
La funzione è stata eseguita correttamente. |
Commenti
Il parametro lpMedia deve puntare a una struttura NTMS_OBJECTINFORMATION , il cui parametro dwType è NTMS_PHYSICAL_MEDIA. Di seguito è riportato un elenco di membri e descrizioni per la struttura NTMS_OBJECTINFORMATION .
| Membro | Descrizione |
|---|---|
| dwSize | [in] CreateNtmsMedia verifica che questa dimensione sia uguale alla lunghezza di una struttura NTMS_OBJECTINFORMATION contenente una struttura NTMS_PMIDINFORMATION . Restituisce ERROR_INVALID_PARAMETER se la dimensione non è corretta. |
| dwType | [in] CreateNtmsMedia verifica che sia stato fornito il valore NTMS_PHYSICAL_MEDIA. Restituisce ERROR_INVALID_PARAMETER se il tipo specificato non è corretto. |
| Creato | [out] Indica l'ora in cui l'oggetto multimediale fisico è stato immesso nel database NTMS. |
| Ultima modifica | [out] Indica l'ora in cui l'oggetto multimediale fisico è stato immesso nel database NTMS. |
| Objectguid | [in/out] Identificatore univoco per l'oggetto multimediale fisico (PMID). Se viene specificato un valore non NULL , il valore viene usato come GUID del supporto fisico; in caso contrario, viene generato un GUID. |
| Enabled | [in] Indica se il supporto fisico deve essere abilitato. |
| dwOperationalState | [out] Deve essere NTMS_READY. |
| Szname | [in/out] CreateNtmsMedia consente a un'applicazione di specificare il nome di un nuovo supporto fisico. Ciò consente all'applicazione di continuare a usare il nome di un supporto dopo averlo spostato da un computer RSM a un altro. La selezione di denominazione predefinita rsm è: per il codice a barre singolo, quindi etichettare il valore o il numero di sequenza;. per codice a barre multimediale su più lati e quindi numero di sequenza.
Si noti che il nome visualizzato nell'interfaccia utente RSM per una partizione è questo nome (il nome assegnato all'oggetto multimediale fisico). |
| szDescription | [in] Parametro facoltativo che può essere impostato usando CreateNtmsMedia. Specificare la stringa vuota ("\0") per evitare di passare un valore per la descrizione. |
Di seguito è riportato un elenco di membri e descrizioni per la struttura NTMS_PMIDINFORMATION .
| Membro | Descrizione |
|---|---|
| CurrentLibrary | [in] Deve essere il NULL_GUID o il GUID della libreria offline. |
| MediaPool | [in] Deve essere il GUID di un pool di importazione o applicazione valido.
CreateNtmsMedia verifica che si tratta del GUID di un'importazione o di un pool di applicazioni valido. Verifica inoltre che il numero di partizioni fornite sia corretto per il tipo di supporto associato a questo pool di supporti. |
| Posizione | [out] Deve essere il NULL_GUID. |
| LocationType | [out] Deve essere NTMS_STORAGESLOT. |
| HomeSlot | [out] Deve essere il NULL_GUID. |
| MediaType | [out] CreateNtmsMedia imposta il tipo di supporto sul tipo di supporto associato al pool multimediale fornito. |
| szBarCode | [in/out] Il codice a barre viene rimosso da qualsiasi spazio finale. CreateNtmsMedia non esegue alcun tentativo aggiuntivo per verificare la validità del codice a barre. |
| BarCodeState | [out] BarCodeState è impostato su NTMS_BARCODESTATE_UNREADABLE se il valore passato per szBarCode è una stringa vuota, altrimenti è impostata su NTMS_BARCODESTATE_OK. |
| szSequenceNumber | [out] CreateNtmsMedia assegna al supporto appena creato un numero di sequenza, restituito in questo membro. |
| MediaState | [out] CreateNtmsMedia imposta MediaState su NTMS_MEDIASTATE_IDLE. |
| dwNumberOfPartitions | [in] Definisce il numero di strutture NTMS_OBJECTINFORMATION che rappresentano i lati per questo mezzo. CreateNtmsMedia verifica che il numero di lati specificati corrisponda al numero di lati impliciti dal pool di supporti a cui deve essere assegnato. Se non corrispondono, ERROR_MEDIA_INCOMPATIBLE viene restituito. |
| dwMediaTypeCode | [in] Codice del tipo di supporto SCSI.
Questo membro non viene usato da RSM, ma può essere usato dalle applicazioni scritte in RSM per altre informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le impostazioni possibili. RSM aggiorna questo membro quando monta il supporto appena importato per la prima volta. |
| dwDensityCode | [in] Codice di densità SCSI.
Questo membro non viene usato da RSM, ma può essere usato dalle applicazioni scritte in RSM per altre informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le impostazioni possibili. RSM aggiorna questo membro quando monta il supporto appena importato per la prima volta |
Il parametro lpList deve puntare a una struttura NTMS_OBJECTINFORMATION il cui dwType è NTMS_PARTITION con le informazioni seguenti.
| Membro | Descrizione |
|---|---|
| dwSize | [in] CreateNtmsMedia verifica che le dimensioni specificate corrispondano alla lunghezza prevista di una struttura NTMS_OBJECTINFORMATION contenente una struttura NTMS_PARTITIONINFORMATION . Restituisce ERROR_INVALID_PARAMETER se la dimensione non è corretta. |
| dwType | [in] CreateNtmsMedia verifica che il valore NTMS_PARTITION sia stato fornito. Restituisce ERROR_INVALID_PARAMETER se il tipo specificato non è corretto. |
| Creato | [out] Indica l'ora in cui l'oggetto di partizione è stato immesso nel database RSM. |
| Ultima modifica | [out] Indica l'ora in cui l'oggetto di partizione è stato immesso nel database RSM. |
| Objectguid | [in/out] Identificatore univoco per il lato. Se viene specificato un valore non NULL , il valore viene usato come GUID del lato; in caso contrario, viene generato un GUID. |
| Enabled | [in] Determina se il lato deve essere abilitato. |
| dwOperationalState | [out] Deve essere NTMS_READY. |
| Szname | [in] Nome di un nuovo lato. |
| szDescription | [in] Parametro facoltativo che può essere impostato usando CreateNtmsMedia. Specificare la stringa vuota ("\0") per evitare di passare un valore per la descrizione. |
| PhysicalMedia | [out] GUID dell'oggetto lato appena creato. |
| LogicalMedia | [in/out] Parametro di input facoltativo, nonché un parametro di output. Se viene specificato il GUID, CreateNtmsMedia tenta di creare un nuovo oggetto multimediale logico con il GUID preassigned. Se il GUID non è univoco, CreateNtmsMedia restituisce un errore. |
| State | [in] Qualsiasi stato lato valido. |
| Lato | [out] CreateNtmsMedia imposta il numero laterale sull'offset nella matrice Partitions. |
| dwOmidLabelIdLength | [in] Deve essere un valore positivo.
CreateNtmsMedia usa dwOmidLabelLabelLength per determinare il numero di byte significativi nel membro OmidLabelId . Se il valore non è corretto, il valore OmidLabelId registrato non è corretto. |
| OmidLabelId | [in] Deve essere un'etichetta multimediale valida che può essere riconosciuta da un MLL installato. |
| szOmidLabelType | [in] Non deve essere una stringa vuota. |
| szOmidLabelInfo | [in] Può essere la stringa vuota. |
| dwMountCount | [in] Qualsiasi valore viene accettato. |
| dwAllocateCount | [in] Qualsiasi valore viene accettato. |
| Capacity | [in] Codice di capacità SCSI.
Questo membro non viene usato da RSM, ma può essere usato dalle applicazioni scritte in RSM per altre informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le impostazioni possibili. RSM aggiorna questo membro quando monta il supporto appena importato per la prima volta. |
Nota
L'intestazione ntmsapi.h definisce CreateNtmsMedia 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 |