GetClipboardFormatNameA, fonction (winuser.h)
Récupère du Presse-papiers le nom du format inscrit spécifié. La fonction copie le nom dans la mémoire tampon spécifiée.
Syntaxe
int GetClipboardFormatNameA(
[in] UINT format,
[out] LPSTR lpszFormatName,
[in] int cchMaxCount
);
Paramètres
[in] format
Type : uiNT
Type de format à récupérer. Ce paramètre ne doit pas spécifier les formats prédéfinis du Presse-papiers.
[out] lpszFormatName
Type : LPTSTR
Mémoire tampon qui doit recevoir le nom du format.
[in] cchMaxCount
Type : int
Longueur maximale, en caractères, de la chaîne à copier dans la mémoire tampon. Si le nom dépasse cette limite, il est tronqué.
Valeur de retour
Type : int
Si la fonction réussit, la valeur de retour est la longueur, en caractères, de la chaîne copiée dans la mémoire tampon.
Si la fonction échoue, la valeur de retour est égale à zéro, indiquant que le format demandé n’existe pas ou est prédéfini. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Considérations relatives à la sécurité
L’utilisation incorrecte de cette fonction peut compromettre la sécurité de votre programme. Par exemple, le calcul incorrect de la taille appropriée de la mémoire tampon lpszFormatName, en particulier lorsque l’application est utilisée dans les versions ANSI et Unicode, peut entraîner un dépassement de capacité de mémoire tampon. Notez également que la chaîne est tronquée si elle est plus longue que le paramètre cchMaxCount, ce qui peut entraîner une perte d’informations.Exemples
Pour obtenir un exemple, consultez Exemple de visionneuse du Presse-papiers.
Note
L’en-tête winuser.h définit GetClipboardFormatName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
| ensemble d’API | ext-ms-win-ntuser-misc-l1-1-0 (introduit dans Windows 8) |
Voir aussi
conceptuelle
de référence