Функция ChangeAccountPasswordW (sspi.h)

Статья
11/20/2024

Функция ChangeAccountPassword изменяет пароль для учетной записи домена Windows с помощью указанногопоставщика поддержки безопасности .

Эта функция поддерживается только поставщиками Microsoft Kerberos, Microsoft Negotiateи поставщиков Microsoft NTLM.

Синтаксис

SECURITY_STATUS SEC_ENTRY ChangeAccountPasswordW(
  [in]      SEC_WCHAR      *pszPackageName,
  [in]      SEC_WCHAR      *pszDomainName,
  [in]      SEC_WCHAR      *pszAccountName,
  [in]      SEC_WCHAR      *pszOldPassword,
  [in]      SEC_WCHAR      *pszNewPassword,
  [in]      BOOLEAN        bImpersonating,
  [in]      unsigned long  dwReserved,
  [in, out] PSecBufferDesc pOutput
);

Параметры

[in] pszPackageName

Имя используемого поставщика. Значение этого параметра должно иметь значение Kerberos, "Согласование" или "NTLM".

[in] pszDomainName

Домен учетной записи, для которой необходимо изменить пароль.

[in] pszAccountName

Имя пользователя учетной записи, для которой необходимо изменить пароль.

[in] pszOldPassword

Старый пароль, который необходимо изменить.

[in] pszNewPassword

Новый пароль для указанной учетной записи.

[in] bImpersonating

TRUE, если вызывающий процесс выполняется в качестве клиента; в противном случае FALSE.

[in] dwReserved

Скрытный. Должно быть задано равно нулю.

[in, out] pOutput

На входных данных указатель на структуру SecBufferDesc. Структура SecBufferDesc должна содержать один буфер типа SECBUFFER_CHANGE_PASS_RESPONSE. В выходных данных pvBuffer элемент этой структуры указывает на DOMAIN_PASSWORD_INFORMATION структуру.

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

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

Если функция завершается ошибкой, возвращается код ошибки.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	sspi.h
библиотеки	Secur32.lib
DLL	Secur32.dll

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