IComponentAuthenticate::SACGetProtocols 메서드(mswmdm.h)

아티클
03/05/2024

SACGetProtocols 메서드는 구성 요소에서 다른 구성 요소에서 지원하는 인증 프로토콜을 검색하는 데 사용됩니다.

구문

HRESULT SACGetProtocols(
  [out] DWORD **ppdwProtocols,
  [out] DWORD *pdwProtocolCount
);

매개 변수

[out] ppdwProtocols

지원되는 프로토콜 배열에 대한 포인터입니다. 이 버전의 Windows Media 장치 관리자 경우 SAC_PROTOCOL_V1 값을 포함하는 단일 요소 DWORD 배열입니다.

[out] pdwProtocolCount

ppdwProtocols에서 반환된 프로토콜 수를 포함하는 DWORD에 대한 포인터입니다. 이 버전에 대한 숫자는 항상 1입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

이 메서드는 서비스 공급자에 의해 구현되며 애플리케이션에서 호출되지 않습니다.

예제

다음 메서드는 서비스 공급자의 SACGetProtocols 메서드 구현을 보여 줍니다. 프라이빗 CSecureChannelServer 멤버에서 CSecureChannelServer::SACGetProtocols를 호출하여 이 작업을 수행합니다.


STDMETHODIMP CMyServiceProvider::SACGetProtocols(
    DWORD **ppdwProtocols,
    DWORD  *pdwProtocolCount)
{
    HRESULT hr = E_FAIL;

    // Verify that the global CSecureChannelServer member is valid.
    if(g_pAppSCServer == NULL)
       return hr;

    hr = g_pAppSCServer->SACGetProtocols(
        ppdwProtocols,
        pdwProtocolCount
    );

    return hr;
}