iComponentAuthenticate：：SACGetProtocols 方法 (mswmdm.h)

项目
02/29/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;
}