LSA_CRACK_SINGLE_NAME fonction de rappel (ntsecpkg.h)

Article
03/06/2024

La fonction CrackSingleName convertit un nom d’un format à un autre.

Syntaxe

LSA_CRACK_SINGLE_NAME LsaCrackSingleName;

NTSTATUS LsaCrackSingleName(
  [in]           ULONG FormatOffered,
  [in]           BOOLEAN PerformAtGC,
  [in]           PUNICODE_STRING NameInput,
  [in, optional] PUNICODE_STRING Prefix,
  [in]           ULONG RequestedFormat,
  [out]          PUNICODE_STRING CrackedName,
  [out]          PUNICODE_STRING DnsDomainName,
  [out]          PULONG SubStatus
)
{...}

Paramètres

[in] FormatOffered

Format du nom d’entrée. Le tableau suivant contient les valeurs valides pour ce paramètre.

Valeur	Signification
DS_CANONICAL_NAME	Nom canonique complet (par exemple, example.microsoft.com/software/someone). La version de domaine uniquement comprend une barre oblique de fin (/).
DS_CANONICAL_NAME_EX	Identique à DS_CANONICAL_NAME sauf que la barre oblique la plus à droite (/) est remplacée par un caractère de ligne nouvelle (\n), même dans un cas de domaine uniquement (par exemple, example.microsoft.com/software\nquelqu’un).
DS_DISPLAY_NAME	Nom d’affichage « convivial ». Le nom d’affichage n’est pas nécessairement le nom unique relatif (RDN).
DS_FQDN_1779_NAME	Nom unique complet (par exemple, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME	Nom du compte Windows (par exemple, Exemple\Nom). La version de domaine uniquement comprend des barres obliques inverses de fin (\\).
DS_SERVICE_PRINCIPAL_NAME	Nom du principal de service généralisé (par exemple, www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME	Identificateur de sécurité (SID) pour l’objet. Il peut s’agir du SID actuel ou d’un SID de l’historique SID de l’objet. La chaîne SID peut utiliser la représentation de chaîne standard d’un SID ou l’une des constantes de chaîne définies dans Sddl.h. Pour plus d’informations sur la conversion d’un SID binaire en chaîne SID, consultez Chaînes SID. Cette valeur n’est pas valide pour le paramètre formatDesired .
DS_UNIQUE_ID_NAME	Chaîne GUID renvoyée par la fonction IIDFromString (par exemple, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).
DS_UNKNOWN_NAME	Type de nom inconnu.
DS_USER_PRINCIPAL_NAME	Nom d’utilisateur principal (par exemple, someone@example.microsoft.com).

[in] PerformAtGC

Spécifie s’il faut effectuer la traduction sur un serveur de catalogue global.

[in] NameInput

Pointeur vers une structure de UNICODE_STRING qui contient le nom à convertir.

[in, optional] Prefix

Pointeur vers une structure UNICODE_STRING qui spécifie un préfixe pour le nom.

[in] RequestedFormat

Format demandé du nom fissuré. Pour obtenir la liste des valeurs valides, consultez le paramètre FormatOffered .

[out] CrackedName

Pointeur vers une structure UNICODE_STRING qui reçoit le nom reformaté.

[out] DnsDomainName

Pointeur vers une structure de UNICODE_STRING qui reçoit le nom du domaine qui possède le nom spécifié par le paramètre NameInput .

[out] SubStatus

Pointeur vers une variable qui reçoit des informations supplémentaires sur la valeur de retour de l’appel de fonction.

Valeur retournée

Si la fonction réussit, la fonction retourne STATUS_SUCCESS.

Si la fonction échoue, elle retourne STATUS_UNSUCCESSFUL. Pour plus d’informations, consultez la valeur retournée dans le paramètre SubStatus .

Remarques

Un pointeur vers la fonction CrackSingleName est disponible dans la structure LSA_SECPKG_FUNCTION_TABLE reçue par la fonction SpInitialize .

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	ntsecpkg.h

Voir aussi

LSA_SECPKG_FUNCTION_TABLE

SpInitialize

Partager via