IVdsService::Unadvise-Methode (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Hebt die Registrierung der IVdsAdviseSink-Schnittstelle des Aufrufers auf, sodass der Aufrufer keine Benachrichtigungen mehr vom VDS-Dienst empfängt.

Syntax

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parameter

[in] dwCookie

Das Cookie, das von der IVdsService::Advise-Methode zurückgegeben wurde, als die IVdsAdviseSink-Schnittstelle registriert wurde.

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 makros HRESULT_FROM_WIN32 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	Die Methode wurde erfolgreich abgeschlossen.
VDS_E_BAD_COOKIE 0x80042411L	Das Cookie ist nicht vorhanden.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor die Initialisierung des Diensts abgeschlossen ist, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn die Initialisierung fehlschlägt, wird dieser Fehler zurückgegeben.

Bemerkungen

Verwenden Sie die Advise-Methode , um die IVdsAdviseSink-Schnittstelle Ihrer VDS-Anwendung zu registrieren, um Benachrichtigungen von VDS zu empfangen. Advise gibt ein Cookie zurück, das Sie als Parameter an die Unadvise-Methode zurückgeben müssen.

Hinweis Eine Anwendung, die Advise aufruft , muss schließlich Unadvise aufrufen. Im Idealfall sollte unadvise aufgerufen werden, sobald keine Benachrichtigungen mehr empfangen werden müssen.

Die Unadvise-Methode wird möglicherweise nicht sofort zurückgegeben, da sie auf eine Sperre wartet, um die Liste der registrierten Clientanwendungen zu aktualisieren, und darauf wartet, dass der Benachrichtigungsthread die Clientbenachrichtigungen beendet. Wenn ausstehende Benachrichtigungen an Ihre Anwendung gesendet werden sollen, versucht der Benachrichtigungsthread, diese vor dem Beenden zu senden.

Anforderungen


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

Siehe auch

IVdsAdviseSink

IVdsService

IVdsService::Advise

VDS-Benachrichtigungen

Freigeben über