Funzione CreateNtmsMediaW (ntmsapi.h)
[ di 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 CreateNtmsMediaW(
[in] HANDLE hSession,
[in] LPNTMS_OBJECTINFORMATIONW lpMedia,
[in] LPNTMS_OBJECTINFORMATIONW lpList,
[in] DWORD dwOptions
);
Parametri
[in] hSession
Handle per la sessione restituita dalla funzione OpenNtmsSession
[in] lpMedia
Puntatore a una struttura NTMS_OBJECTINFORMATION che contiene 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ò essere 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 del supporto 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 negato. 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 importazione o applicazione valido. |
|
Parametro mancante oppure le informazioni sull'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. |
Osservazioni
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 specificato 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. |
| modificato | [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 diNULL, il valore viene usato come GUID del supporto fisico; in caso contrario, viene generato un GUID. |
| abilitato | [in] Indica se il supporto fisico deve essere abilitato o meno. |
| 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 predefinita della denominazione RSM è: per un singolo lato: codice a barre, quindi Valore informazioni etichetta o 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 pool di applicazioni o importazione valido. Verifica inoltre che il numero di partizioni fornite sia corretto per il tipo di supporto associato a questo pool di supporti. |
| percorso | [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 di supporti fornito. |
| szBarCode | [in/out] Il codice a barre viene rimosso da eventuali spazi finali. CreateNtmsMedia non esegue ulteriori tentativi di verifica della validità del codice a barre. |
| BarCodeState | [out] Il BarCodeState |
| 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 supporto. CreateNtmsMedia verifica che il numero di lati specificato corrisponda al numero di lati impliciti dal pool di supporti a cui deve essere assegnato. Se non corrispondono, viene restituito ERROR_MEDIA_INCOMPATIBLE. |
| 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 ulteriori informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le possibili impostazioni. 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 ulteriori informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le possibili impostazioni. RSM aggiorna questo membro quando monta il supporto appena importato per la prima volta |
Il parametro lpList
| 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 sia stato specificato il valore NTMS_PARTITION. Restituisce ERROR_INVALID_PARAMETER se il tipo specificato non è corretto. |
| Creato | [out] Indica l'ora in cui l'oggetto partizione è stato immesso nel database RSM. |
| modificato | [out] Indica l'ora in cui l'oggetto partizione è stato immesso nel database RSM. |
| objectGuid | [in/out] Identificatore univoco per il lato. Se viene specificato un valore NULL non |
| abilitato | [in] Determina se il lato deve essere abilitato o meno. |
| 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 preassegnato. Se il GUID non è univoco, CreateNtmsMedia restituisce un errore. |
| stato | [in] Qualsiasi stato laterale valido. |
| lato | [out] CreateNtmsMedia imposta il numero laterale sul relativo offset nella matrice Partitions. |
| dwOmidLabelIdLength | [in] Deve essere un valore positivo.
CreateNtmsMedia usa il dwOmidLabelIdLength per determinare il numero di byte significativi nel membro OmidLabelId. Se il valore non è corretto, il 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. |
| capacità | [in] Codice di capacità SCSI.
Questo membro non viene usato da RSM, ma può essere usato dalle applicazioni scritte in RSM per ulteriori informazioni sui supporti. Per una descrizione di ciò che deve essere impostato su questo membro, vedere la specifica SCSI del produttore hardware per le possibili impostazioni. 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 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 |