Fonction RtlCreateUnicodeString (ntifs.h)

  • Article

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