IVdsService::Advise-Methode (vds.h)

  • Artikel

[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
S_OK
 Die Registrierung wurde erfolgreich abgeschlossen.
VDS_E_INITIALIZED_FAILED
0x80042401L
 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.

Hinweis Eine Anwendung, die Advise aufruft, muss schließlich Unadvise aufrufen. Im Idealfall sollte es Unadvise aufrufen, sobald keine Benachrichtigungen mehr empfangen werden müssen.
 
Zum Empfangen von Benachrichtigungen von zugrunde liegenden Software- und Hardwareanbietern übergibt VDS eine Benachrichtigungsrückruffunktion an jeden Anbieter als Parameter der IVdsProviderPrivate::OnLoad-Methode .

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

Weitere Informationen

IVdsAdviseSink

IVdsProviderPrivate::OnLoad

IVdsService

VDS-Benachrichtigungen