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

予約済み。 0 に設定する必要があります。

[in, out] pOutput

入力時に、 SecBufferDesc 構造体へのポインター。 SecBufferDesc 構造体には、SECBUFFER_CHANGE_PASS_RESPONSE型の 1 つのバッファーが含まれている必要があります。 出力では、その構造体の pvBuffer メンバーは 、DOMAIN_PASSWORD_INFORMATION 構造体を指します。

戻り値

関数が成功した場合、関数はSEC_E_OKを返します。

関数が失敗した場合はエラー コードを返します。

注釈

注意

sspi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ChangeAccountPassword を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	sspi.h
Library	Secur32.lib
[DLL]	Secur32.dll