Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DataObject.IDataObject.DAdvise (FORMATETC, ADVF, IAdviseSink, Int32)

 

Data di pubblicazione: ottobre 2016

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice.

Crea una connessione tra un oggetto dati e un sink consultivo. Questo metodo viene chiamato da un oggetto che supporta un sink consultivo e abilita tale sink per ricevere una notifica delle modifiche nei dati dell'oggetto.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
int IDataObject.DAdvise(
	ref FORMATETC pFormatetc,
	ADVF advf,
	IAdviseSink pAdvSink,
	out int pdwConnection
)

Parametri

pFormatetc
Type: System.Runtime.InteropServices.ComTypes.FORMATETC

Oggetto FORMATETC struttura, passato per riferimento, che definisce formato, dispositivo di destinazione, aspetto e supporto che verrà utilizzato per notifiche future.

advf
Type: System.Runtime.InteropServices.ComTypes.ADVF

Uno del ADVF valori che specifica un gruppo di flag per il controllo della connessione consultiva.

pAdvSink
Type: System.Runtime.InteropServices.ComTypes.IAdviseSink

Un puntatore per il IAdviseSink interfaccia nel sink consultivo che riceverà la notifica di modifica.

pdwConnection
Type: System.Int32

Quando termina, questo metodo contiene un puntatore a un token DWORD che identifica la connessione. È possibile utilizzare questo token in un secondo momento per eliminare la connessione consultiva passandolo al DUnadvise. Se il valore è zero, la connessione non è stata stabilita. Questo parametro viene passato non inizializzato.

Valore restituito

Type: System.Int32

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché quanto segue:

Valore

Descrizione

S_OK

La connessione consultiva è stata creata.

E_NOTIMPL

Questo metodo non è implementato nell'oggetto dati.

DV_E_LINDEX

È un valore non valido per lindex; attualmente è supportato solo -1.

DV_E_FORMATETC

È un valore non valido per il pFormatetc parametro.

OLE_E_ADVISENOTSUPPORTED

L'oggetto dati non supporta la notifica delle modifiche.

Questo membro è un'implementazione esplicita di un membro di interfaccia. Può essere utilizzato solo quando si esegue il cast della classe DataObject su un'interfaccia IDataObject.

SecurityPermission

for calling unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: