Fonction RtlUnalignedStringCbLengthW (ntstrsafe.h)

  • Article

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

Syntaxe

NTSTRSAFEDDI RtlUnalignedStringCbLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cbMax,
  [out, optional] size_t           *pcbLength
);

Paramètres

[in] psz

Fournit un pointeur vers une mémoire tampon qui contient une chaîne terminée par null dont la longueur RtlUnalignedStringCbLengthW case activée.

[in] cbMax

Fournit le nombre maximal d’octets autorisés dans la mémoire tampon vers laquelle psz pointe, y compris le caractère NULL de fin. Cette valeur ne peut pas dépasser NTSTRSAFE_MAX_CCH * sizeof(WCHAR).

[out, optional] pcbLength

facultatif. Si l’appelant fournit un pointeur d’adresse non NULL , la fonction charge l’adresse avec la longueur, en octets, 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 retournée

RtlUnalignedStringCbLengthW retourne l’une des valeurs NTSTATUS suivantes.

Code de retour Description
STATUS_SUCCESS
 Cette status de réussite signifie que la chaîne que le paramètre psz spécifié 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 à des octets cbMax.
STATUS_INVALID_PARAMETER
 Cette erreur status signifie que la valeur dans psz est NULL, que cbMax est supérieure à NTSTRSAFE_MAX_CCH * sizeof(WCHAR, ou que psz est plus long que cbMax.
 

Pour plus d’informations sur le test des valeurs NTSTATUS, consultez Utilisation de valeurs NTSTATUS.

Remarques

La fonction RtlUnalignedStringCbLengthW est disponible pour les architectures de processeur, telles que itanium et x64, qui provoquent des exceptions d’alignement lorsque le logiciel tente d’accéder à des données non alignées. Sur ces processeurs, vous pouvez utiliser RtlUnalignedStringCbLengthW au lieu de la fonction RtlStringCbLength pour éviter les exceptions d’alignement. (Pour les processeurs qui ne provoquent pas d’exceptions d’alignement, RtlUnalignedStringCbLengthW équivaut à RtlStringCbLength.)

Pour plus d’informations sur les fonctions de chaîne sécurisée, consultez Utilisation des fonctions de chaîne sécurisée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP avec Service Pack 1 (SP1) et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ntstrsafe.h (inclure Ntstrsafe.h)
Bibliothèque Ntstrsafe.lib
IRQL PASSIVE_LEVEL

Voir aussi

RtlStringCbLength