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型の単一のバッファーが含まれている必要があります。 出力時に、その構造体の pvBuffer メンバーは、DOMAIN_PASSWORD_INFORMATION 構造体を指します。

戻り値

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

関数が失敗すると、エラー コードが返されます。

備考

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	sspi.h
ライブラリ	Secur32.lib
DLL	Secur32.dll