функция обратного вызова LSA_CRACK_SINGLE_NAME (ntsecpkg.h)

Статья
08/25/2023

Функция CrackSingleName преобразует имя из одного формата в другой.

Синтаксис

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

Параметры

[in] FormatOffered

Формат имени входных данных. В следующей таблице содержатся допустимые значения для этого параметра.

Значение	Значение
DS_CANONICAL_NAME	Полное каноническое имя (например, example.microsoft.com/software/someone). Версия только для домена включает косую черту в конце (/).
DS_CANONICAL_NAME_EX	Аналогично DS_CANONICAL_NAME за исключением того, что крайняя правая косая черта (/) заменяется символом новой строки (\n) даже в случае только для домена (например, example.microsoft.com/software\nкем-то).
DS_DISPLAY_NAME	Понятное отображаемое имя. Отображаемое имя не обязательно является определяющим относительным различающимся именем (RDN).
DS_FQDN_1779_NAME	Полное различающееся имя (например, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME	Имя учетной записи Windows (например, Example\Name). Версия только для домена включает в себя конечные обратные косые знаки (\\).
DS_SERVICE_PRINCIPAL_NAME	Обобщенное имя субъекта-службы (например, www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME	Идентификатор безопасности (SID) для объекта. Это может быть текущий идентификатор безопасности или идентификатор безопасности из журнала идентификаторов безопасности объекта. Строка sid может использовать либо стандартное строковое представление sid, либо одну из строковых констант, определенных в Sddl.h. Сведения о преобразовании двоичного идентификатора безопасности в строку sid см. в разделе Строки идентификатора безопасности. Это значение недопустимо для параметра formatDesired .
DS_UNIQUE_ID_NAME	Строка GUID, возвращаемая функцией IIDFromString (например, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).
DS_UNKNOWN_NAME	Неизвестный тип имени.
DS_USER_PRINCIPAL_NAME	Имя участника-пользователя (например, someone@example.microsoft.com).

[in] PerformAtGC

Указывает, следует ли выполнять преобразование на сервере глобального каталога.

[in] NameInput

Указатель на структуру UNICODE_STRING , содержащую имя для преобразования.

[in, optional] Prefix

Указатель на структуру UNICODE_STRING , указывающую префикс для имени.

[in] RequestedFormat

Запрошенный формат взломавого имени. Список допустимых значений см. в параметре FormatOffered .

[out] CrackedName

Указатель на структуру UNICODE_STRING , получающую переформатированное имя.

[out] DnsDomainName

Указатель на структуру UNICODE_STRING , получающую имя домена, которому принадлежит имя, указанное параметром NameInput .

[out] SubStatus

Указатель на переменную, получающую дополнительные сведения о возвращаемом значении вызова функции.

Возвращаемое значение

Если функция выполнена успешно, функция возвращает STATUS_SUCCESS.

Если функция завершается сбоем, она возвращает STATUS_UNSUCCESSFUL. Дополнительные сведения см. в разделе Значение, возвращаемое в параметре SubStatus .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	ntsecpkg.h

См. также раздел

LSA_SECPKG_FUNCTION_TABLE

SpInitialize