IVdsIscsiInitiatorAdapter::LogoutFromTarget-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Führt eine manuelle Abmeldung von einem iSCSI-Ziel für alle iSCSI-Sitzungen an das angegebene Ziel aus.
Syntax
HRESULT LogoutFromTarget(
[in] VDS_OBJECT_ID targetId,
[out] IVdsAsync **ppAsync
);
Parameter
[in] targetId
Der VDS_OBJECT_ID des Ziels, von dem sich abmelden 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 für diese Schnittstelle aufgerufen wird und ein success 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 |
|---|---|
|
Die Portalgruppe wurde erfolgreich gelöscht. |
|
Fehler beim Abmelden. |
|
VDS konnte keine Sitzung finden, die dem angegebenen Ziel entspricht. |
|
Mindestens eine Sitzung wurde nicht erfolgreich abmelden. |
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |