IVdsService::Advise-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.]
Registriert die IVdsAdviseSink-Schnittstelle des Aufrufers bei VDS, sodass der Aufrufer Benachrichtigungen vom VDS-Dienst empfängt.
Syntax
HRESULT Advise(
[in] IVdsAdviseSink *pSink,
[out] DWORD *pdwCookie
);
Parameter
[in] pSink
Ein Zeiger auf die IVdsAdviseSink-Schnittstelle .
[out] pdwCookie
Ein Zeiger auf ein Cookie, das später zum Aufheben der Registrierung der Schnittstelle verwendet werden kann.
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 Registrierung wurde erfolgreich abgeschlossen. |
|
VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben. |
Hinweise
Zum Empfangen von Benachrichtigungen vom VDS-Dienst muss Ihre Anwendung die IVdsAdviseSink-Schnittstelle implementieren und die Advise-Methode verwenden, um die Schnittstelle zu registrieren.
Um den Empfang von Benachrichtigungen vom VDS-Dienst zu beenden, verwenden Sie die IVdsService::Unadvise-Methode , um die Registrierung der IVdsAdviseSink-Schnittstelle aufzuheben.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |