IComponentAuthenticate::SACGetProtocols-Methode (mswmdm.h)

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

Authentifizieren des Dienstanbieters

CSecureChannelServer::SACGetProtocols

IComponentAuthenticate-Schnittstelle