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

DWORD 的指標，其中包含ppdwProtocols中傳回的通訊協定數目。此版本的數位一律為 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;
}