IComponentAuthenticate

IComponentAuthenticate インターフェースは、Windows Media Device Manager のモジュール間で安全な暗号化通信を提供します。

SACAuth メソッドは、コンポーネント間にセキュアな認証済みチャネルを確立します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェースメソッドは、次のいずれかの種類のエラーコードを返すことがあります。

• 標準の COM エラーコード
• HRESULT 値に変換された Windows エラーコード
• Windows Media Device Manager のエラーコード

このメソッドはサービスプロバイダーのみが呼び出します。プロトコル識別子に応じて、1 回以上呼び出されます。

pbDataIn および ppbDataOut のデータ構造は、dwProtocolID と dwPass の値によって決まります。

例

次の C++ コードは、サービスプロバイダーによる SACAuth の実装例を示しています。あらかじめ作成しておいたプライベートな CSecureChannelServer メンバーに対して CSecureChannelServer::SACAuth を呼び出しています。

HRESULT CMyServiceProvider::SACAuth(
    DWORD   dwProtocolID,
    DWORD   dwPass,
    BYTE   *pbDataIn,
    DWORD   dwDataInLen,
    BYTE  **ppbDataOut,
    DWORD  *pdwDataOutLen)
{
    HRESULT hr = S_OK;

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

    hr = g_pAppSCServer->SACAuth(
        dwProtocolID,
        dwPass,
        pbDataIn, dwDataInLen,
        ppbDataOut, pdwDataOutLen
    );
    return hr;
}

SACGetProtocols メソッドは、コンポーネントが他のコンポーネントのサポートする認証プロトコルを取得するために使用します。

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェースメソッドは、次のいずれかの種類のエラーコードを返すことがあります。

• 標準の COM エラーコード
• HRESULT 値に変換された Windows エラーコード
• Windows Media Device Manager のエラーコード

このメソッドはサービスプロバイダーが実装するものであり、アプリケーションから呼び出されることはありません。

例

次のメソッドは、サービスプロバイダーによる 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;
}