Partager via

Fonction RtlConvertSidToUnicodeString (winternl.h)

  • Article

[La fonction RtlConvertSidToUnicodeString est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction ConvertSidToStringSid .]

La fonction RtlConvertSidToUnicodeString convertit un identificateur de sécurité (SID) en sa représentation en caractères Unicode. Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Ntdll.dll.

Syntaxe

NTSTATUS RtlConvertSidToUnicodeString(
  [out] PUNICODE_STRING UnicodeString,
  [in]  PSID            Sid,
  [in]  BOOLEAN         AllocateDestinationString
);

Paramètres

[out] UnicodeString

Pointeur vers la représentation en caractères Unicode de l’identificateur de sécurité.

[in] Sid

Pointeur vers la structure SID qui représente l’identificateur de sécurité.

[in] AllocateDestinationString

Si la valeur est TRUE, UnicodeString est alloué au nom de l’appelant et il incombe à l’appelant de libérer la mémoire allouée en appelant la fonction RtlFreeUnicodeString . Si la valeur est FALSE, l’appelant est responsable de l’allocation et de la libération d’UnicodeString.

Valeur retournée

La valeur de retour est un code NTSTATUS. Une valeur de STATUS_SUCCESS (0x00000000L) est retournée si la fonction réussit.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winternl.h
Bibliothèque ntdll.lib
DLL ntdll.dll