Metodo IOleObject::GetClipboardData (oleidl.h)
Recupera un oggetto dati contenente il contenuto corrente dell'oggetto incorporato in cui viene chiamato questo metodo. Usando il puntatore a questo oggetto dati, è possibile creare un nuovo oggetto incorporato con gli stessi dati dell'originale.
Sintassi
HRESULT GetClipboardData(
[in] DWORD dwReserved,
[out] IDataObject **ppDataObject
);
Parametri
[in] dwReserved
Questo parametro è riservato e deve essere zero.
[out] ppDataObject
Indirizzo della variabile puntatore IDataObject che riceve il puntatore dell'interfaccia all'oggetto dati. Se si verifica un errore, ppDataObject deve essere impostato su NULL. Ogni volta che un oggetto riceve una chiamata a IOleObject::GetClipboardData, deve aumentare il conteggio dei riferimenti su ppDataObject. È responsabilità del chiamante chiamare Release quando viene eseguita con ppDataObject.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
Codice restituito | Descrizione |
---|---|
|
GetClipboardData non è supportato. |
|
L'oggetto non è in esecuzione. |
Commenti
È possibile usare il metodo IOleObject::GetClipboardData per convertire un oggetto collegato in un oggetto incorporato, in cui l'applicazione contenitore chiamerebbe IOleObject::GetClipboardData e quindi passare i dati ricevuti a OleCreateFromData. Questo metodo restituisce un puntatore a un oggetto dati identico a quello che sarebbe stato passato agli Appunti da un'operazione di copia standard.
Note ai chiamanti
Se si vuole uno snapshot stabile del contenuto corrente di un oggetto incorporato, chiamare IOleObject::GetClipboardData. Se si modificano i dati, sarà necessario chiamare di nuovo la funzione per uno snapshot aggiornato. Se si vuole che il chiamante venga informato delle modifiche apportate ai dati, chiamare QueryInterface, chiamare IDataObject::D Advise.Note per gli implementatori
Se si implementa questa funzione, è necessario restituire un puntatore IDataObject per un oggetto i cui dati non verranno modificati.Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | oleidl.h |