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;
}