ICredentialProviderEvents::CredentialsChanged 메서드(credentialprovider.h)

열거된 자격 증명 목록이 변경되었음을 로그온 UI 또는 자격 증명 UI에 신호를 보냅니다. 이는 자격 증명 수가 변경되거나, 개별 자격 증명이 변경되거나, 사용 가능한 필드 수가 변경되는 경우에 발생합니다. 비동기 메서드입니다.

구문

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

매개 변수

[in] upAdviseContext

형식: UINT_PTR

다시 열거를 요청한 자격 증명 공급자를 고유하게 식별하는 정수에 대한 포인터입니다. 자격 증명 공급자는 이 매개 변수의 Advise 에서 받은 인터페이스 포인터를 다시 전달해야 합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이전에는 많은 자격 증명 공급자가 ICredentialProviderEvents::CredentialsChanged 를 사용하여 UI를 업데이트했습니다. 이렇게 하면 호출 자격 증명 공급자에서 모든 자격 증명이 다시 열거됩니다. 이 이벤트를 처리하면 경우에 따라 이 다시 열거로 인해 UI가 깜박이거나 포커스가 변경됩니다. 따라서 UI 업데이트에 대해서만 ICredentialProviderEvents::CredentialsChanged 를 사용하는 것은 권장되지 않습니다. 새 권장 사항은 다음과 같습니다.

• 자격 증명 공급자가 자동 로그온을 수행하거나 열거 중인 자격 증명 수를 변경해야 하는 경우에만 ICredentialProviderEvents::CredentialsChanged 를 사용합니다.
• ICredentialProviderCredentialEvents2를 사용하여 자격 증명 공급자의 로그온 UI 또는 자격 증명 UI를 업데이트합니다.

요구 사항

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