Metodo IVdsIscsiPortalGroup::AddPortal (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.

Aggiunge un portale a un gruppo di portale. Un portale può appartenere solo a un singolo gruppo di portali all'interno di una determinata destinazione. Può appartenere ad altri gruppi di portale in altre destinazioni.

Sintassi

HRESULT AddPortal(
  [in]  VDS_OBJECT_ID portalId,
  [out] IVdsAsync     **ppAsync
);

Parametri

[in] portalId

VDS_OBJECT_ID del portale da aggiungere al gruppo del portale.

[out] ppAsync

Indirizzo di un puntatore dell'interfaccia IVdsAsync . VDS inizializza l'interfaccia in caso di restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questa interfaccia per annullare, attendere o eseguire query sullo stato dell'operazione. Se viene chiamato IVdsAsync::Wait 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.

Requisiti

Vedi anche

IVdsAsync

IVdsIscsiPortalGroup