Metodo IVdsService::Unadvise (vds.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Annulla la registrazione dell'interfaccia IVdsAdviseSink del chiamante in modo che il chiamante non riceva più notifiche dal servizio VDS.

Sintassi

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parametri

[in] dwCookie

Cookie restituito dal metodo IVdsService::Advise quando è stata registrata l'interfaccia IVdsAdviseSink .

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	Metodo completato correttamente.
VDS_E_BAD_COOKIE 0x80042411L	Il cookie non esiste.
VDS_E_INITIALIZED_FAILED 0x80042401L	Impossibile inizializzare VDS. Se un'applicazione chiama questo metodo prima che il servizio completi l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

Commenti

Usare il metodo Advise per registrare l'interfaccia IVdsAdviseSink dell'applicazione VDS per ricevere notifiche da VDS. Consiglia di restituire un cookie, che è necessario passare di nuovo come parametro al metodo Unadvise .

Nota Un'applicazione che chiama Advise deve infine chiamare Unadvise. Idealmente, dovrebbe chiamare Unadvise non appena non deve più ricevere notifiche.

Il metodo Unadvise potrebbe non restituire immediatamente, perché attende che un blocco aggiorni l'elenco di applicazioni client registrate e attenda che il thread di notifica invii le notifiche client per uscire. Se sono presenti notifiche in sospeso da inviare all'applicazione, il thread di notifica tenta di inviarle prima di uscire.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib

Vedi anche

Condividi tramite