Leggere in inglese

Condividi tramite


Metodo IVdsService::Unadvise (vds.h)

[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

IVdsAdviseSink

IVdsService

IVdsService::Advise

Notifiche VDS