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

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

  • Статья

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

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

Синтаксис

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

Параметры

[in] pszPackageName

Имя используемого поставщика. Этот параметр должен иметь значение "Kerberos", "Negotiate" или "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 [только классические приложения]
Целевая платформа Windows
Header sspi.h
Библиотека Secur32.lib
DLL Secur32.dll