Fonction RtlUnalignedStringCchLengthW (ntstrsafe.h)

Article
02/07/2025

La fonction RtlUnalignedStringCchLengthW est une version de la fonction RtlStringCchLength qui accepte un pointeur non aligné vers une chaîne de caractères Unicode.

Syntaxe

NTSTRSAFEDDI RtlUnalignedStringCchLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cchMax,
  [out, optional] size_t           *pcchLength
);

Paramètres

[in] psz

Fournit un pointeur vers une mémoire tampon qui contient une chaîne terminée par null dont la longueur RtlUnalignedStringCchLengthW vérifie.

[in] cchMax

Fournit le nombre maximal de caractères autorisés dans la mémoire tampon qui psz pointe vers, y compris le caractère NULL de fin. Cette valeur ne peut pas dépasser NTSTRSAFE_MAX_CCH.

[out, optional] pcchLength

Optionnel. Si l’appelant fournit un pointeur d’adresse null nonNULL, la fonction charge l’adresse avec la longueur, en caractères, de la chaîne contenue dans la mémoire tampon vers laquelle psz pointe. La longueur n’inclut pas le caractère NULL de fin de la chaîne.

Valeur de retour

RtlUnalignedStringCchLengthW retourne l’une des valeurs NTSTATUS suivantes.

Retourner le code	Description
STATUS_SUCCESS	Cette 'état de réussite signifie que la chaîne que le paramètre psz n’était pas NULL et que la longueur de la chaîne (y compris le caractère NULL de fin) était inférieure ou égale à caractères cchMax.
STATUS_INVALID_PARAMETER	Cette erreur 'état signifie que la valeur dans psz est NULL, cchMax est supérieure à NTSTRSAFE_MAX_CCH, ou psz est plus long que cchMax.

Pour plus d’informations sur la façon de tester des valeurs NTSTATUS, consultez Using NTSTATUS Values.

Remarques

La fonction RtlUnalignedStringCchLengthW est disponible pour les architectures de processeur, telles qu’Itanium et x64, qui provoquent des exceptions d’alignement lorsque les logiciels tentent d’accéder à des données non alignées. Sur ces processeurs, vous pouvez utiliser RtlUnalignedStringCchLengthW au lieu de RtlStringCchLength pour éviter les exceptions d’alignement. (Pour les processeurs qui ne provoquent pas d’exceptions d’alignement, RtlUnalignedStringCchLengthW équivaut à RtlStringCchLength.)

Pour plus d’informations sur les fonctions de chaîne sécurisée, consultez Using Safe String Functions.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows XP avec Service Pack 1 (SP1) et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	ntstrsafe.h (include Ntstrsafe.h)
bibliothèque	Ntstrsafe.lib
IRQL	Si les chaînes manipulées résident toujours en mémoire, sinon PASSIVE_LEVEL

Voir aussi

RtlStringCchLength

Partager via