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

추가 정보

ICredentialProvider

ICredentialProvider::UnAdvise