LSA_CRACK_SINGLE_NAME Rückruffunktion (ntsecpkg.h)

Artikel
03/04/2024

Die Funktion CrackSingleName konvertiert einen Namen aus einem Format in ein anderes.

Syntax

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
)
{...}

Parameter

[in] FormatOffered

Das Format des Eingabenamens. Die folgende Tabelle enthält die gültigen Werte für diesen Parameter.

Wert	Bedeutung
DS_CANONICAL_NAME	Vollständiger kanonischer Name (z. B. example.microsoft.com/software/someone). Die reine Domänenversion enthält einen nachgestellten Schrägstrich (/).
DS_CANONICAL_NAME_EX	Identisch mit DS_CANONICAL_NAME mit der Ausnahme, dass der rechtsste Schrägstrich (/) durch ein Zeilenumbruchzeichen (\n) ersetzt wird, auch in einem fall, der nur für die Domäne gilt (z. B. example.microsoft.com/software\njemand).
DS_DISPLAY_NAME	Ein anzeigefreundlicher Name. Der Anzeigename ist nicht notwendigerweise der definierende relative Distinguished Name (RDN).
DS_FQDN_1779_NAME	Vollqualifizierter distinguished Name (z. B. CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME	Name des Windows-Kontos (z. B. Example\Name). Die reine Domänenversion enthält nachfolgende umgekehrte Schrägstriche (\\).
DS_SERVICE_PRINCIPAL_NAME	Generalisierter Dienstprinzipalname (z. B. www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME	Eine Sicherheits-ID (SID) für das -Objekt. Dies kann entweder die aktuelle SID oder eine SID aus dem SID-Verlauf des Objekts sein. Die SID-Zeichenfolge kann entweder die Standardzeichenfolgendarstellung einer SID oder eine der in Sddl.h definierten Zeichenfolgenkonstanten verwenden. Informationen zum Konvertieren einer binären SID in eine SID-Zeichenfolge finden Sie unter SID-Zeichenfolgen. Dieser Wert ist für den parameter formatDesired ungültig.
DS_UNIQUE_ID_NAME	GUID-Zeichenfolge, die von der IIDFromString-Funktion zurückgegeben wird (z. B. {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).
DS_UNKNOWN_NAME	Unbekannter Namenstyp.
DS_USER_PRINCIPAL_NAME	Benutzerprinzipalname (z. B someone@example.microsoft.com. ).

[in] PerformAtGC

Gibt an, ob die Übersetzung auf einem globalen Katalogserver ausgeführt werden soll.

[in] NameInput

Ein Zeiger auf eine UNICODE_STRING Struktur, die den zu konvertierenden Namen enthält.

[in, optional] Prefix

Ein Zeiger auf eine UNICODE_STRING-Struktur , die ein Präfix für den Namen angibt.

[in] RequestedFormat

Das angeforderte Format des gesprungenen Namens. Eine Liste der gültigen Werte finden Sie im FormatOffered-Parameter .

[out] CrackedName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den neu formatierten Namen empfängt.

[out] DnsDomainName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Namen der Domäne empfängt, die den durch den NameInput-Parameter angegebenen Namen besitzt.

[out] SubStatus

Ein Zeiger auf eine Variable, die zusätzliche Informationen zum Rückgabewert des Funktionsaufrufs empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, wird STATUS_UNSUCCESSFUL zurückgegeben. Weitere Informationen finden Sie unter dem Wert, der im SubStatus-Parameter zurückgegeben wird.

Hinweise

Ein Zeiger auf die CrackSingleName-Funktion ist in der LSA_SECPKG_FUNCTION_TABLE-Struktur verfügbar, die von der SpInitialize-Funktion empfangen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecpkg.h

Weitere Informationen

LSA_SECPKG_FUNCTION_TABLE

SpInitialize

Freigeben über