ChangeAccountPasswordW 関数 (sspi.h)

  • [アーティクル]

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

要件

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