Partager via


LSA_CRACK_SINGLE_NAME fonction de rappel (ntsecpkg.h)

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