Metodo IVdsHwProviderStoragePools::CreateLunInStoragePool (vds.h)

Articolo
03/03/2024

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Crea un LUN in un pool di archiviazione.

Sintassi

HRESULT CreateLunInStoragePool(
  [in]  VDS_LUN_TYPE  type,
  [in]  ULONGLONG     ullSizeInBytes,
  [in]  VDS_OBJECT_ID StoragePoolId,
  [in]  LPWSTR        pwszUnmaskingList,
  [in]  VDS_HINTS2    *pHints2,
  [out] IVdsAsync     **ppAsync
);

Parametri

[in] type

Valore di enumerazione VDS_LUN_TYPE che specifica il tipo di LUN da creare. Il nuovo LUN può essere un tipo automagic o un tipo RAID specifico, ma non entrambi. Se il chiamante specifica un tipo automagic, è necessario specificare uno o più hint automagic nel parametro pHints2 .

Il puntatore dell'interfaccia per il nuovo oggetto LUN può essere recuperato chiamando il metodo IVdsAsync::Wait sul puntatore dell'interfaccia restituito nel parametro ppAsync . La struttura VDS_ASYNC_OUTPUT restituita da Wait contiene il puntatore dell'interfaccia dell'oggetto LUN nel membro cl.pLunUnk .

[in] ullSizeInBytes

Dimensioni, in byte, del nuovo LUN. Il provider può arrotondare le dimensioni fino o giù per soddisfare i requisiti di allineamento o altre restrizioni. Nella maggior parte dei casi, il provider esegue il round up, assicurandosi che, con eccezioni rare, il LUN sia almeno di grandi dimensioni richiesto.

Dopo aver creato il LUN, il chiamante può determinare le dimensioni effettive del LUN chiamando il metodo IVdsLun::GetProperties .

[in] StoragePoolId

Valore VDS_OBJECT_ID che identifica il pool di archiviazione in cui deve essere creato il LUN. Questo parametro è obbligatorio e non può essere GUID_NULL.

[in] pwszUnmaskingList

Elenco che specifica i computer da concedere all'accesso al LUN. L'elenco è una stringa delimitata da punto e virgola, con terminazione NULL, leggibile.

Se il valore è "", tutti i computer con una porta HBA collegata al sottosistema di archiviazione devono essere concessi l'accesso al LUN. Se il valore è "", nessun computer deve essere concesso l'accesso al LUN.

Nota In pratica, se il valore è "", la maggior parte dei provider hardware concede solo le porte e gli iniziatori nel computer locale accesso al LUN.

Se viene specificato "*" o "", non è possibile specificare alcun altro valore.

Per le reti Fibre Channel e le reti SCSI associate seriali (SAS), ogni voce è un nome world-wide (WWN) a 64 bit di ogni porta a cui il LUN è smascherato, formattato come stringa esadecimale (16 caratteri long), primo byte significativo. Ad esempio, un indirizzo WWN di 01:23:45:67:89:AB:CD:EF viene rappresentato come "0123456789ABCDEF". Per altre informazioni, vedere le specifiche T10 per Fibre Channel e SAS.

Per le reti iSCSI, ogni voce è un nome qualificato iSCSI (IQN) di ogni iniziatore a cui il LUN è senza maschera. Un LUN non mascherato a un particolare iniziatore viene considerato associato a tale iniziatore.

Nota L'elenco di annullamento del mascheramento può contenere la stessa WWN o IQN più di una volta. Il chiamante non è previsto rimuovere duplicati dall'elenco o per convalidare il formato della WWN o dell'IQN.

Dopo aver creato il LUN, il chiamante può determinare l'elenco di smascheramento effettivo chiamando il metodo IVdsLun::GetProperties .

[in] pHints2

Puntatore a una struttura VDS_HINTS2 che specifica gli hint da usare nella creazione del LUN. Il provider non è necessario per applicare gli hint al LUN. Gli hint specificati nella struttura VDS_HINTS2 sono solo una richiesta al provider.

Dopo aver creato il LUN, il chiamante può determinare gli hint applicati dal provider chiamando il metodo IVdsLun2::QueryHints2 .

Se il parametro di tipo specifica un tipo non automagic, questo parametro deve essere NULL.

[out] ppAsync

Puntatore a un'interfaccia IVdsAsync che al termine del completamento riceve l'interfaccia IVdsAsync per monitorare e controllare questa operazione. I chiamanti devono rilasciare l'interfaccia ricevuta al termine dell'operazione. Se il metodo IVdsAsync::Wait viene chiamato sull'interfaccia e viene restituito un valore HRESULT riuscito, le interfacce restituite nella struttura VDS_ASYNC_OUTPUT devono essere rilasciate chiamando il metodo IUnknown::Release in ogni puntatore dell'interfaccia. Tuttavia, se Wait restituisce un valore HRESULT non riuscito o se il parametro pHrResultdiWait riceve un valore HRESULT non riuscito, i puntatori di interfaccia nella struttura VDS_ASYNC_OUTPUT sono NULL e non devono essere rilasciati. È possibile testare i valori HRESULT di esito positivo o negativo usando le macro SUCCESSED e FAILED definite in Winerror.h.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.

Commenti

Scegliendo i valori appropriati per i parametri di tipo e pHints2 , il chiamante può specificare gli attributi del LUN completamente, parzialmente o minimamente. Il provider può includere automaticamente attributi non specificati, in base agli hint automagic specificati nella struttura VDS_HINTS2 a cui punta il parametro pHints2 .

Note per gli implementatori: Il provider deve restituire un puntatore dell'interfaccia IVdsAsync nel parametro ppAsync , anche se la chiamata a questo metodo non avvia un'operazione asincrona.

L'elenco di WWN e IQN nel parametro pwszUnmaskingList può contenere nomi duplicati. È responsabilità del provider convalidare tutti i nomi nell'elenco e rimuovere duplicati se necessario.

In risposta al metodo CreateLunInStoragePool e prima di rimuovere il nuovo LUN in qualsiasi host, il provider deve riempire il primo e l'ultimo megabyte con zero, lasciando il LUN non inizializzato.

Esiste una differenza sottile tra i valori restituiti E_INVALIDARG e VDS_E_NOT_SUPPORTED . I provider non devono implementare tutte le funzionalità che l'API VDS può presentare a un client. Ad esempio, il metodo CreateLunInStoragePool espone la possibilità di creare molti tipi diversi di LUN, ad esempio semplici, mirror, striped e parità. Tuttavia, i provider non sono necessari per supportare tutti i tipi di LUN. Se il chiamante specifica un valore per il parametro di tipo non valido VDS_LUN_TYPE valore di enumerazione, il provider deve restituire E_INVALIDARG. Se il chiamante specifica un valore di tipo valido che il provider non supporta, il provider deve restituire VDS_E_NOT_SUPPORTED.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib

Vedi anche

IVdsHwProviderStoragePools

IVdsLun2::QueryHints2

IVdsLun::GetProperties

VDS_HINTS2

VDS_LUN_TYPE

Condividi tramite