ICredentialProvider::Advise 메서드(credentialprovider.h)
자격 증명 공급자가 콜백 인터페이스를 통해 로그온 UI 또는 자격 증명 UI에서 이벤트를 시작할 수 있습니다.
구문
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
매개 변수
[in] pcpe
형식: ICredentialProviderEvents*
알림 메커니즘으로 사용할 ICredentialProviderEvents 콜백 인터페이스에 대한 포인터입니다.
[in] upAdviseContext
형식: UINT_PTR
다시 열거를 요청한 자격 증명 공급자를 고유하게 식별하는 정수에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
메서드를 구현할 필요가 없으며 그렇지 않으면 E_NOTIMPL 반환해야 합니다. 로그온 UI 또는 자격 증명 UI가 변경되지 않거나 업데이트되지 않는 경우와 같이 호출할 이유가 없을 수 있습니다.
이 메서드를 사용하면 로그온 UI 및 자격 증명 UI가 ICredentialProviderEvents 포인터를 자격 증명 공급자에 전달할 수 있습니다. 이렇게 하면 자격 증명 공급자가 로그온 또는 자격 증명 UI와 비동기 콜백 통신을 수행할 수 있습니다. 예를 들어 스마트 카드 공급자는 새 스마트 카드 삽입될 때 자격 증명을 다시 열거하려고 할 수 있습니다. 자격 증명을 다시 가져오기 위해 로그온 UI를 트리거하려면 자격 증명 공급자가 upAdviseContext 식별자를 제공하는 CredentialsChanged를 호출해야 합니다.
이 메서드를 구현하는 자격 증명 공급자는 제공된 ICredentialProviderEvents에서 AddRef를 호출해야 합니다. 또한 이러한 자격 증명 공급자는 UnAdvise 메서드 중에 Release를 호출해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | credentialprovider.h |