Fonction IsDBCSLeadByteEx (winnls.h)

Détermine si un caractère spécifié est potentiellement un octet de prospect. Un octet principal est le premier octet d’un caractère de deux octets dans un jeu de caractères codés sur deux octets (DBCS) pour la page de codes.

Syntaxe

BOOL IsDBCSLeadByteEx(
  [in] UINT CodePage,
  [in] BYTE TestChar
);

Paramètres

[in] CodePage

Identificateur de la page de codes utilisée pour case activée plages d’octets de prospect. Ce paramètre peut être l’un des identificateurs de page de codes définis dans les constantes Unicode et jeu de caractères ou l’une des valeurs prédéfinies suivantes. Cette fonction valide les valeurs d’octets de prospect uniquement dans les pages de codes 932, 936, 949, 950 et 1361.

Valeur	Signification
CP_ACP	Utilisez la page de codes Windows ANSI par défaut.
CP_MACCP	Utilisez la page de codes Macintosh par défaut du système.
CP_OEMCP	Utilisez la page de codes OEM par défaut du système.
CP_THREAD_ACP	Utilisez la page de codes Windows ANSI pour le thread actuel.

[in] TestChar

Caractère à tester.

Valeur retournée

Retourne une valeur différente de zéro si l’octet est un octet de prospect. La fonction retourne 0 si l’octet n’est pas un octet de début ou si le caractère est un caractère codé sur un octet. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError.

Remarques

Note Cette fonction ne valide pas la présence ou la validité d’un octet de piste. Par conséquent, MultiByteToWideChar peut ne pas reconnaître une séquence que l’application utilisant IsDBCSLeadByte signale en tant qu’octet de prospect. L’application peut facilement être non synchronisée avec les résultats de MultiByteToWideChar, ce qui peut entraîner des erreurs inattendues ou des incompatibilités de taille de mémoire tampon.

 

En général, au lieu de tenter une manipulation de bas niveau des données de page de code, les applications doivent utiliser MultiByteToWideChar pour convertir les données en UTF-16 et les utiliser dans cet encodage.

Les valeurs d’octets de prospect sont spécifiques à chaque DBCS distinct. Certaines valeurs d’octets peuvent apparaître dans une page de codes unique en tant qu’octet de début et d’octet de fin d’un caractère DBCS. Ainsi, IsDBCSLeadByteEx peut uniquement indiquer une valeur potentielle d’octets de prospect.

Pour donner un sens à une chaîne DBCS, une application commence normalement au début de la chaîne et analyse vers l’avant, en effectuant le suivi lorsqu’elle rencontre un octet de début et en traitant l’octet suivant comme la partie de fin du même caractère. Pour effectuer une sauvegarde, l’application doit utiliser CharPrevExA au lieu d’essayer de développer son propre algorithme.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

MultiByteToWideChar

Fonctions Unicode et jeu de caractères

Unicode et jeux de caractères

WideCharToMultiByte