OleDataObject.IDataObject.DAdvise(FORMATETC[], UInt32, IAdviseSink, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Estabelece uma conexão entre o objeto de dados e um objeto chamador implementando IAdviseSink .
virtual int Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise(cli::array <Microsoft::VisualStudio::OLE::Interop::FORMATETC> ^ pFormatetc, System::UInt32 ADVF, Microsoft::VisualStudio::OLE::Interop::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] System::UInt32 % pdwConnection) = Microsoft::VisualStudio::OLE::Interop::IDataObject::DAdvise;
int IDataObject.DAdvise (Microsoft.VisualStudio.OLE.Interop.FORMATETC[] pFormatetc, uint ADVF, Microsoft.VisualStudio.OLE.Interop.IAdviseSink pAdvSink, out uint pdwConnection);
abstract member Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
override this.Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
Function DAdvise (pFormatetc As FORMATETC(), ADVF As UInteger, pAdvSink As IAdviseSink, ByRef pdwConnection As UInteger) As Integer Implements IDataObject.DAdvise
Parâmetros
- pFormatetc
- FORMATETC[]
Ponteiro para uma FORMATETC estrutura que define o formato, o dispositivo de destino, o aspecto e a mídia que serão usados para notificações futuras. Por exemplo, um coletor pode querer saber apenas quando a representação de bitmap dos dados no objeto de dados é alterada. Outro coletor pode estar interessado apenas no formato de metarquivo do mesmo objeto. Cada coletor de aviso é notificado quando os dados de interesse são alterados. Esses dados são passados de volta para o coletor de aviso quando a notificação ocorre.
- ADVF
- UInt32
DWORD Isso especifica um grupo de sinalizadores para controlar a conexão de consultoria. Os valores válidos são da enumeração ADVF. No entanto, apenas alguns dos possíveis valores de ADVF são relevantes para esse método.
- pAdvSink
- IAdviseSink
Ponteiro para a IAdviseSink interface no coletor de aviso que receberá a notificação de alteração.
- pdwConnection
- UInt32
Ponteiro para um DWORD token que identifica essa conexão. Você pode usar esse token posteriormente para excluir a conexão de consultoria (passando-a para DUnadvise . Se esse valor for zero, a conexão não terá sido estabelecida.
Retornos
Se o método tiver sido bem-sucedido, S_OK , caso contrário, um código de erro.