Metodo IVdsIscsiTarget::CreatePortalGroup (vdshwprv.h)
[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 gruppo di portali. Il puntatore dell'interfaccia per il nuovo oggetto gruppo del portale può essere recuperato chiamando IVdsAsync::Wait tramite il parametro ppAsync . La struttura VDS_ASYNC_OUTPUT restituita contiene il puntatore dell'interfaccia dell'oggetto volume nel membro cpg.pPortalGroupUnk .
Sintassi
HRESULT CreatePortalGroup(
[out] IVdsAsync **ppAsync
);
Parametri
[out] ppAsync
Indirizzo di un puntatore dell'interfaccia IVdsAsync , che il VDS inizializza sul ritorno. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire query sullo stato dell'operazione. Se si chiama il metodo IVdsAsync::Wait in questa interfaccia e viene restituito un valore HRESULT riuscito, è necessario rilasciare le interfacce restituite nella struttura VDS_ASYNC_OUTPUT 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/valore restituito | Descrizione |
|---|---|
|
Il gruppo del portale è stato creato correttamente. |
|
Non è possibile creare altri gruppi di portale. Il metodo CreatePortalGroup non ha creato un nuovo gruppo di portale. Se si chiama il metodo IVdsAsync::Wait sul puntatore dell'interfaccia restituito nel parametro ppAsync , viene recuperato un oggetto gruppo di portali esistente. |
|
La cache del provider è danneggiata. Ciò indica un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sui dispositivi collegati. Il chiamante può usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider ::Refresh per ripristinare la cache. |
|
L'oggetto di destinazione non è più presente. |
|
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento delle operazioni precedenti. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vdshwprv.h |
| Libreria | Uuid.lib |
| Componente ridistribuibile | VDS 1.1 |