IVdsService::Unadvise-Methode (vds.h)
[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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Das Cookie ist nicht vorhanden. |
|
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.
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 |