IComponentAuthenticate::SACGetProtocols-Methode (mswmdm.h)

Artikel
03/04/2024

Die SACGetProtocols-Methode wird von einer Komponente verwendet, um die von einer anderen Komponente unterstützten Authentifizierungsprotokolle zu ermitteln.

Syntax

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

Parameter

[out] ppdwProtocols

Zeiger auf ein Array unterstützter Protokolle. Für diese Version von Windows Media Geräte-Manager handelt es sich um ein DWORD-Array mit einem Element, das den Wert SAC_PROTOCOL_V1 enthält.

[out] pdwProtocolCount

Zeiger auf ein DWORD , das die Anzahl der in ppdwProtocols zurückgegebenen Protokolle enthält. Die Zahl ist für diese Version immer 1.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode wird von einem Dienstanbieter implementiert und nie von einer Anwendung aufgerufen.

Beispiele

Die folgende Methode veranschaulicht die Implementierung der SACGetProtocols-Methode durch einen Dienstanbieter. Dazu wird CSecureChannelServer::SACGetProtocols auf seinem privaten CSecureChannelServer-Member aufgerufen.


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