Funzione GetClipboardData (winuser.h)

Articolo
08/27/2023

Recupera i dati dagli Appunti in un formato specificato. Gli Appunti devono essere stati aperti in precedenza.

Sintassi

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parametri

[in] uFormat

Tipo: UINT

Formato appunti. Per una descrizione dei formati standard degli Appunti, vedere Formati standard degli Appunti.

Valore restituito

Tipo: HANDLE

Se la funzione ha esito positivo, il valore restituito è l'handle di un oggetto Appunti nel formato specificato.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Attenzione I dati degli Appunti non sono attendibili. Analizzare attentamente i dati prima di usarli nell'applicazione.

Un'applicazione può enumerare i formati disponibili in anticipo usando la funzione EnumClipboardFormats .

Gli Appunti controllano l'handle restituito dalla funzione GetClipboardData , non dall'applicazione. L'applicazione deve copiare immediatamente i dati. L'applicazione non deve liberare l'handle né lasciarla bloccata. L'applicazione non deve usare l'handle dopo aver chiamato la funzione EmptyClipboard o CloseClipboard oppure dopo che la funzione SetClipboardData viene chiamata con lo stesso formato degli Appunti.

Il sistema esegue conversioni di formato dati implicite tra determinati formati appunti quando un'applicazione chiama la funzione GetClipboardData . Ad esempio, se il formato CF_OEMTEXT si trova negli Appunti, una finestra può recuperare i dati nel formato CF_TEXT . Il formato negli Appunti viene convertito nel formato richiesto su richiesta. Per altre informazioni, vedere Formati degli Appunti sintetizzati.

Esempio

Per un esempio, vedere Copia di informazioni negli Appunti.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)