Funzione GetClipboardFormatNameA (winuser.h)

Articolo
11/20/2024

Recupera dagli Appunti il nome del formato registrato specificato. La funzione copia il nome nel buffer specificato.

Sintassi

int GetClipboardFormatNameA(
  [in]  UINT  format,
  [out] LPSTR 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, a indicare che il formato richiesto non esiste o è predefinito. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

considerazioni sulla sicurezza di

L'uso di questa funzione potrebbe compromettere erroneamente la sicurezza del programma. Ad esempio, il calcolo errato delle dimensioni appropriate del buffer lpszFormatName buffer, 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.

Esempi

Per un esempio, vedere esempio di un 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)

Vedere anche

Appunti

concettuale

EnumClipboardFormats

riferimento

RegisterClipboardFormat

Condividi tramite