NPPasswordChangeNotify 함수(npapi.h)

  • 아티클

참고

이 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

MPR은 이 함수를 호출하여 자격 증명 관리자에게 암호 변경 이벤트를 알립니다. NPPasswordChangeNotify 함수는 자격 증명 관리자 DLL에 의해 구현됩니다.

구문

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

매개 변수

[in] lpAuthentInfoType

lpAuthentInfo가 가리키는 구조체의 형식을 식별하는 문자열에 대한 포인터입니다.

Microsoft가 기본 인증자인 경우 대화형 및 서비스 컨트롤러 로그온에 대해 다음 문자열이 지정됩니다.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

새 자격 증명을 포함하는 구조체에 대한 포인터입니다.

Microsoft가 기본 인증자( 즉, lpAuthentifoType 이 "MSV1_0:Interactive" 또는 "Kerberos:Interactive"인 경우)인 경우 사용되는 구조는 MSV1_0_INTERACTIVE_LOGON 또는 KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

lpPreviousAuthentInfo가 가리키는 구조체의 형식을 식별하는 문자열에 대한 포인터입니다. 포인터가 NULL이면 이전 정보가 없습니다. 여기서 예상되는 값은 lpAuthentInfoType의 값과 동일합니다.

Microsoft가 기본 인증자인 경우 대화형 및 서비스 컨트롤러 로그온에 대해 다음 문자열이 지정됩니다.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

인증 정보가 변경되기 전에 사용되는 자격 증명을 포함하는 구조체에 대한 포인터입니다. 사용자가 로그온하기 전에 암호(또는 기타 인증 정보)를 변경해야 하는 경우 이전 정보가 제공됩니다. 사용자가 인증 정보를 강제로 변경하지 않은 경우 이 포인터는 NULL입니다. 여기서 예상되는 값은 lpAuthentInfo의 값과 동일합니다.

Microsoft가 기본 인증자인 경우 사용되는 구조는 MSV1_0_INTERACTIVE_LOGON 또는 KERB_INTERACTIVE_LOGON.

[in] lpStationName

사용자가 로그온한 스테이션의 이름을 지정하는 문자열에 대한 포인터입니다. 스테이션 이름을 사용하여 추가 공급자 관련 정보를 가져올 수 있는지 여부를 확인할 수 있습니다.

Microsoft가 기본 인증자인 경우 다음 문자열 중 하나가 지정됩니다.

값 의미
WinSta_0
 창 스테이션을 통한 대화형 로그온임을 나타냅니다. 이 경우 StationHandle 은 부모 대화 상자에 대한 HWND 입니다.
SvcCtl
 서비스 컨트롤러에서 시작한 로그온임을 나타냅니다. 이 경우에는 StationHandle 이 사용되지 않습니다.

[in] StationHandle

의미가 lpStationName에 지정된 스테이션의 이름(및 결과적으로 형식)에 따라 달라지는 32비트 값입니다.

값 의미
WinSta_0
 현재 화면에 표시되는 소유자 대화 상자(hwndOwner)에 대한 핸들입니다.
SvcCtl
 임의 데이터. 사용하지 마십시오.

[in] dwChangeInfo

설정되면 변경 정보를 제공하는 플래그를 지정합니다. 이 매개 변수는 플래그 중 하나일 수 있습니다.

값 의미
WN_VALID_LOGON_ACCOUNT
 이 플래그는 변경된 인증 정보가 향후 모든 로그온에 영향을 줍니다. 사용자가 신뢰할 수 있는 도메인에 속합니다.
WN_NT_PASSWORD_CHANGED
 이 플래그는 암호가 변경되었음을 나타냅니다.

일부 인증 정보 변경 내용은 신뢰할 수 없는 도메인에서 수행한 연결에만 영향을 줍니다. 사용자가 이 컴퓨터에 로그온하는 데 사용할 수 없는 계정입니다. 이러한 경우 dwChangeInfo 가 설정되지 않습니다.

반환 값

함수가 성공하면 함수는 WN_SUCCESS 반환합니다.

함수가 실패하면 다음 값 중 하나일 수 있는 오류 코드를 반환합니다.

반환 코드 설명
WN_NOT_SUPPORTED

NPPasswordChangeNotify 는 지원되지 않습니다.
WN_NO_NETWORK
 네트워크가 없습니다.
WN_FUNCTION_BUSY
 자격 증명 관리자가 아직 초기화 중이며 호출할 준비가 되지 않았습니다.

설명

NPPasswordChangeNotify 함수는 인증 정보가 변경될 때 알림을 수신하기 위해 자격 증명 관리자에 의해 구현됩니다.

Windows Server 2003 및 Windows XP: 암호가 다른 곳에서 변경된 경우 사용자가 로그인하는 컴퓨터에서 NPPasswordChangeNotify가 호출됩니다. 이 동작은 Windows Vista 및 Windows Server 2008부터 지원되지 않습니다.

요구 사항

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

추가 정보

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify