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

Функция DsServerRegisterSpn состоит из двух субъектов-служб для службы на основе узла. Имена основаны на именах DNS и NetBIOS локального компьютера. Функция изменяет атрибут servicePrincipalName указанной учетной записи или учетной записи, связанной с вызывающим потоком. Функция регистрирует или отменяет регистрацию имен субъектов-служб.

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

Синтаксис

NTDSAPI DWORD DsServerRegisterSpnA(
  [in]           DS_SPN_WRITE_OP Operation,
  [in]           LPCSTR          ServiceClass,
  [in, optional] LPCSTR          UserObjectDN
);

Параметры

[in] Operation

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

DS_SPN_ADD_SPN_OP

Добавляет имена субъектов-служб в учетную запись пользователя или компьютера.

DS_SPN_DELETE_SPN_OP

Удаляет указанные имена субъектов-служб из учетной записи.

DS_SPN_REPLACE_SPN_OP

Удаляет все домены субъекта-службы, зарегистрированные в настоящее время в учетной записи пользователя или компьютера, и заменяет их новыми именами субъектов-служб.

[in] ServiceClass

Указатель на строку, завершающую значение NULL, указывающую класс службы. Этот параметр может быть любой строкой, уникальной для этой службы; имя протокола (например, ldap) или строковая форма GUID будет работать.

[in, optional] UserObjectDN

Указатель на строку, завершающую значение NULL, указывающую различающееся имя объекта учетной записи пользователя или компьютера для записи имен субъектов-служб. Если этот параметр null, DsServerRegisterSpn записывает в объект учетной записи основного или олицетворенного пользователя, связанного с вызывающим потоком. Если поток выполняется в контексте безопасности учетной записи LocalSystem, функция записывается в объект учетной записи локального компьютера.

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

Если функция успешно регистрирует одну или несколько субъектов-служб, она возвращает ERROR_SUCCESS. Изменение выполняется постоянно, поэтому добавление значения, которое уже существует, не возвращает ошибку.

Замечания

Два имени субъекта-службы, созданные функцией DsServerRegisterSpn, имеют следующий формат:

<ServiceClass>/<host>

В одном имени субъекта-службы главный компьютер — это полное DNS-имя локального компьютера. В другом имени субъекта-службы компонент узла — это имя NetBIOS локального компьютера.

В большинстве случаев вызывающий объект dsServerRegisterSpn должен иметь права администратора домена, чтобы успешно изменить атрибут servicePrincipalName объекта учетной записи. Исключение этого правила заключается в том, что вызывающий поток выполняется в учетной записи LocalSystem, DsServerRegisterSpn допускается, если параметр UserObjectDN имеет значение NULL или указывает различающееся имя учетной записи локального компьютера.

Требования

См. также

функции управления доменами и репликацией

DsGetSpn

DsWriteAccountSpn