Funzione RegisterClipboardFormatW (winuser.h)

Articolo
03/04/2024

Registra un nuovo formato degli Appunti. Questo formato può quindi essere usato come formato valido degli Appunti.

Sintassi

UINT RegisterClipboardFormatW(
  [in] LPCWSTR lpszFormat
);

Parametri

[in] lpszFormat

Tipo: LPCTSTR

Nome del nuovo formato.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito identifica il formato degli Appunti registrati.

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

Commenti

Se esiste già un formato registrato con il nome specificato, non viene registrato un nuovo formato e il valore restituito identifica il formato esistente. Ciò consente a più applicazioni di copiare e incollare i dati usando lo stesso formato degli Appunti registrati. Si noti che il confronto tra nomi di formato non fa distinzione tra maiuscole e minuscole.

I formati degli Appunti registrati sono identificati da valori nell'intervallo 0xC000 tramite 0xFFFF.

Quando i formati degli Appunti registrati vengono inseriti o recuperati dagli Appunti, devono essere sotto forma di valore HGLOBAL .

Esempio

Per un esempio, vedere Registrazione di un formato degli Appunti.

Nota

L'intestazione winuser.h definisce RegisterClipboardFormat come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
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)