IVdsIscsiPortalGroup::RemovePortal-Methode (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Entfernt ein Portal aus einer Portalgruppe.

Syntax

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

Parameter

[in] portalId

Die VDS_OBJECT_ID des Portals, das aus der Portalgruppe entfernt werden soll.

[out] ppAsync

Die Adresse eines IVdsAsync-Schnittstellenzeigers . VDS initialisiert die Schnittstelle bei der Rückgabe. Aufrufer müssen die Schnittstelle freigeben. Verwenden Sie diese Schnittstelle, um den Status des Vorgangs abzubrechen, abzuwarten oder abzufragen. Wenn IVdsAsync::Wait aufgerufen und ein erfolgreicher HRESULT-Wert zurückgegeben wird, müssen die in der VDS_ASYNC_OUTPUT-Struktur zurückgegebenen Schnittstellen durch Aufrufen der IUnknown::Release-Methode für jeden Schnittstellenzeiger freigegeben werden. Wenn Wait jedoch einen Fehler-HRESULT-Wert zurückgibt oder wenn der pHrResult-Parameter von Wait einen Fehler-HRESULT-Wert empfängt, sind die Schnittstellenzeiger in der VDS_ASYNC_OUTPUT Struktur NULL und müssen nicht freigegeben werden. Sie können mit den in Winerror.h definierten Makros SUCCEEDED und FAILED auf Erfolg oder Fehler HRESULT-Werte testen.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Das Portal wurde erfolgreich aus der Portalgruppe entfernt.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Der Cache des Anbieters ist beschädigt. Dies gibt ein Software- oder Kommunikationsproblem innerhalb eines Anbieters an, der Informationen zu den angefügten Geräten zwischenspeichert. Der Aufrufer kann die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode verwenden, um den Cache wiederherzustellen.
VDS_E_OBJECT_DELETED 0x8004240BL	Das Portalgruppenobjekt ist nicht mehr vorhanden.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn die vorherigen Vorgänge abgeschlossen sind.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Der portalID-Parameter verweist nicht auf ein vorhandenes Objekt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h
Bibliothek	Uuid.lib
Verteilbare Komponente	VDS 1.1

Weitere Informationen

IVdsAsync

IVdsIscsiPortalGroup

Share via