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 헤더는 CHANGEAccountPassword를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	sspi.h
라이브러리	Secur32.lib
DLL	Secur32.dll