Поделиться через

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

  • Статья

Функция 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 .

Комментарии

Указатель на функцию CrackSingleName доступен в структуре LSA_SECPKG_FUNCTION_TABLE , полученной функцией SpInitialize .

Требования

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

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

LSA_SECPKG_FUNCTION_TABLE

SpInitialize