Fonction RtlCreateUnicodeString (ntifs.h)

Article
02/29/2024

La routine RtlCreateUnicodeString crée une chaîne Unicode comptée.

Syntaxe

NTSYSAPI BOOLEAN RtlCreateUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PCWSTR          SourceString
);

Paramètres

[out] DestinationString

Pointeur vers la chaîne Unicode nouvellement allouée et initialisée.

[in] SourceString

Pointeur vers une chaîne Unicode terminée par une valeur Null avec laquelle initialiser la nouvelle chaîne.

Valeur retournée

RtlCreateUnicodeString retourne TRUE si la chaîne Unicode a été correctement créée, false dans le cas contraire.

Remarques

DestinationString est alloué à partir d’un pool paginé. L’appelant est chargé de libérer le DestinationString en appelant RtlFreeUnicodeString.

Pour plus d’informations sur les autres routines de gestion de chaînes, consultez les fonctions de manipulation de chaînes dans les routines de la bibliothèque à l’exécution (RTL).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	PASSIVE_LEVEL

Voir aussi

RtlFreeUnicodeString

UNICODE_STRING

Partager via