Fonction RtlCreateUnicodeString (ntifs.h)
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 null avec laquelle initialiser la nouvelle chaîne.
Valeur de retour
RtlCreateUnicodeString retourne TRUE si la chaîne Unicode a été créée avec succès, FALSE sinon.
Remarques
Le DestinationString est alloué à partir du pool paginé. L’appelant est chargé de libérer le DestinationString en appelant RtlFreeUnicodeString.
Pour plus d’informations sur les autres routines de gestion des chaînes, consultez les fonctions de manipulation de chaîne dans les routines de Run-Time bibliothèque (RTL).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur) |
| IRQL | PASSIVE_LEVEL |