Funzione GetClipboardFormatNameW (winuser.h)
Recupera dagli Appunti il nome del formato registrato specificato. La funzione copia il nome nel buffer specificato.
Sintassi
int GetClipboardFormatNameW(
[in] UINT format,
[out] LPWSTR lpszFormatName,
[in] int cchMaxCount
);
Parametri
[in] format
Tipo: UINT
Tipo di formato da recuperare. Questo parametro non deve specificare uno dei formati predefiniti degli Appunti.
[out] lpszFormatName
Tipo: LPTSTR
Buffer che deve ricevere il nome del formato.
[in] cchMaxCount
Tipo: int
Lunghezza massima, in caratteri, della stringa da copiare nel buffer. Se il nome supera questo limite, viene troncato.
Valore restituito
Tipo: int
Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri, della stringa copiata nel buffer.
Se la funzione ha esito negativo, il valore restituito è zero, che indica che il formato richiesto non esiste o è predefinito. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Considerazioni sulla sicurezza
L'uso di questa funzione potrebbe compromettere in modo errato la sicurezza del programma. Ad esempio, la mancata calcolo delle dimensioni appropriate del buffer lpszFormatName , in particolare quando l'applicazione viene usata in versioni ANSI e Unicode, può causare un overflow del buffer. Si noti inoltre che la stringa viene troncata se è più lunga del parametro cchMaxCount , che può causare la perdita di informazioni.Esempio
Per un esempio, vedere Esempio di visualizzatore Appunti.
Nota
L'intestazione winuser.h definisce GetClipboardFormatName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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-1-0 (introdotto in Windows 8) |
Vedi anche
Informazioni concettuali
Riferimento