Функция DsBindWithSpnExA (ntdsapi.h)

Статья
08/25/2023

Функция DsBindWithSpnEx привязывается к контроллеру домена, используя указанные учетные данные и определенное имя субъекта-службы (SPN) для взаимной проверки подлинности. Эта функция аналогична функции DsBindWithSpn , за исключением того, что эта функция позволяет использовать дополнительные параметры привязки с параметром BindFlags .

Эта функция предоставляется в тех случаях, когда требуется полный контроль над взаимной проверкой подлинности. Не используйте эту функцию, если ожидается, что DsBind найдет сервер, так как имена субъектов-служб зависят от компьютера и маловероятно, что указанное имя субъекта-службы будет соответствовать серверу, который dsBind найдет. Предоставление аргументаServicePrincipalName null приводит к поведению, идентичном поведению DsBindWithCred.

Синтаксис

NTDSAPI_POSTXP DWORD DsBindWithSpnExA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [in, optional] LPCSTR                   ServicePrincipalName,
  [in, optional] DWORD                    BindFlags,
  [out]          HANDLE                   *phDS
);

Параметры

[in, optional] DomainControllerName

Указатель на строку, завершающуюся нулевым значением, которая содержит полное DNS-имя домена для привязки. Дополнительные сведения см. в описании DomainControllerName в разделе DsBind .

[in, optional] DnsDomainName

Указатель на строку, завершающуюся нулевым значением, которая содержит полное DNS-имя домена для привязки. Дополнительные сведения см. в описании DnsDomainName в разделе DsBind .

[in, optional] AuthIdentity

Содержит значение RPC_AUTH_IDENTITY_HANDLE , представляющее учетные данные, используемые для привязки. The

Для получения этого значения используется функция DsMakePasswordCredentials. Если этот параметр имеет значение NULL, используются учетные данные вызывающего потока.

Перед освобождением этого дескриптора с помощью функции DsFreePasswordCredentials необходимо вызвать DsUnBind.

[in, optional] ServicePrincipalName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя субъекта-службы, назначаемого клиенту. Передача null в ServicePrincipalName эквивалентна вызову функции DsBindWithCred .

[in, optional] BindFlags

Содержит набор флагов, определяющих поведение этой функции. Этот параметр может содержать ноль или сочетание значений, перечисленных в следующем списке.

NTDSAPI_BIND_ALLOW_DELEGATION (1)

Заставляет привязку использовать уровень олицетворения делегата. Это позволяет выполнять операции, требующие делегирования, например DsAddSidHistory. Указание этого флага также приводит к тому, что DsBindWithSpnEx будет работать так же, как DsBindWithSpn.

Если этот флаг не указан, привязка будет использовать уровень олицетворения. Дополнительные сведения см. в разделе Уровни олицетворения.

Для большинства операций не требуется уровень олицетворения делегата, поэтому этот флаг следует указывать только в том случае, если это абсолютно необходимо. Привязка к серверу-изгою с уровнем олицетворения делегата позволит серверу-изгою подключиться к серверу, не являющемся мошенническим, с вашими учетными данными и выполнять непреднамеренные операции.

NTDSAPI_BIND_FIND_BINDING (2)

Зарезервировано.

NTDSAPI_BIND_FORCE_KERBEROS (4)

Службы Active Directory облегченного доступа к каталогу. Если этот флаг указан, DsBindWithSpnEx принудительно использует проверку подлинности Kerberos. Если не удается установить проверку подлинности Kerberos, DsBindWithSpnEx не будет пытаться выполнить проверку подлинности с помощью любого другого метода.

[out] phDS

Адрес значения HANDLE , получающего дескриптор привязки. Чтобы закрыть этот дескриптор, передайте его в функцию DsUnBind .

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или кода ошибки Windows или RPC. В следующем списке перечислены распространенные коды ошибок.

Заголовок ntdsapi.h определяет DsBindWithSpnEx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll