Método IOleObject::GetClipboardData (oleidl.h)

Artigo
08/25/2023

Recupera um objeto de dados que contém o conteúdo atual do objeto inserido no qual esse método é chamado. Usando o ponteiro para esse objeto de dados, é possível criar um novo objeto inserido com os mesmos dados que o original.

Sintaxe

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

Parâmetros

[in] dwReserved

Esse parâmetro é reservado e precisa ser zero.

[out] ppDataObject

Endereço da variável de ponteiro IDataObject que recebe o ponteiro de interface para o objeto de dados. Se ocorrer um erro, ppDataObject deverá ser definido como NULL. Sempre que um objeto recebe uma chamada para IOleObject::GetClipboardData, ele deve aumentar a contagem de referência em ppDataObject. É responsabilidade do chamador chamar Release quando for feito com ppDataObject.

Valor retornado

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_NOTIMPL	Não há suporte para GetClipboardData.
OLE_E_NOTRUNNING	O objeto não está em execução.

Comentários

Você pode usar o método IOleObject::GetClipboardData para converter um objeto vinculado em um objeto inserido, nesse caso, o aplicativo de contêiner chamaria IOleObject::GetClipboardData e, em seguida, passaria os dados recebidos para OleCreateFromData. Esse método retorna um ponteiro para um objeto de dados idêntico ao que teria sido passado para a área de transferência por uma operação de cópia padrão.

Anotações para chamadores

Se você quiser uma instantâneo estável do conteúdo atual de um objeto inserido, chame IOleObject::GetClipboardData. Se os dados forem alterados, você precisará chamar a função novamente para uma instantâneo atualizada. Se você quiser que o chamador seja informado sobre as alterações que ocorrem nos dados, chame QueryInterface e chame IDataObject::D Advise.

Anotações aos implementadores

Se você implementar essa função, deverá retornar um ponteiro IDataObject para um objeto cujos dados não serão alterados.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h