PSAM_PASSWORD_NOTIFICATION_ROUTINE 콜백 함수(ntsecapi.h)

PasswordChangeNotify 함수는 암호 필터 DLL에 의해 구현됩니다. 암호가 변경되었음을 DLL에 알릴 수 있습니다.

구문

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

매개 변수

[in] UserName

암호가 변경된 사용자의 계정 이름입니다.

이 매개 변수와 NewPassword 매개 변수의 값이 NULL이면 이 함수는 STATUS_SUCCESS 반환해야 합니다.

[in] RelativeId

UserName에 지정된 사용자의 RID(상대 식별자)입니다.

[in] NewPassword

UserName에 지정된 사용자의 새 일반 텍스트 암호입니다. 암호 사용을 마쳤으면 SecureZeroMemory 함수를 호출하여 정보를 지웁 수 있습니다. 암호 보호에 대한 자세한 내용은 암호 처리를 참조하세요.

이 매개 변수의 값과 UserName 매개 변수가 NULL인 경우 이 함수는 STATUS_SUCCESS 반환해야 합니다.

반환 값

반환 코드	설명
STATUS_SUCCESS	사용자의 암호가 변경되었거나 UserName 및 NewPassword 매개 변수의 값이 NULL임을 나타냅니다.

설명

PasswordChangeNotify 함수는 PasswordFilter 함수가 성공적으로 호출되고 새 암호가 저장된 후에 호출됩니다.

이 함수는 __stdcall 호출 규칙을 사용해야 하며 DLL에서 내보내야 합니다.

PasswordChangeNotify 루틴이 실행 중이면 루틴이 완료될 때까지 처리가 차단됩니다. 적절한 경우 이 루틴에서 반환하기 전에 긴 처리를 별도의 스레드로 이동합니다.

이 함수는 시스템에 설치되고 등록된 암호 필터 에 대해서만 호출됩니다.

이 함수 내에서 처리되지 않는 프로세스 예외는 시스템 전체에서 보안 관련 오류를 일으킬 수 있습니다. 적절한 경우 구조적 예외 처리를 사용해야 합니다.

원하는 정보	참조 항목
암호 필터 DLL을 구현할 때 발생하는 프로그래밍 문제	암호 필터 프로그래밍 고려 사항
사용자 고유의 암호 필터 DLL을 설치하고 등록하는 방법	암호 필터 DLL 설치 및 등록
Microsoft에서 제공하는 암호 필터 DLL	강력한 암호 적용 및 Passfilt.dll

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntsecapi.h

추가 정보

InitializeChangeNotify

PasswordFilter