Metodo IComponentAuthenticate::SACGetProtocols (mswmdm.h)

Articolo
02/29/2024

Il metodo SACGetProtocols viene usato da un componente per individuare i protocolli di autenticazione supportati da un altro componente.

Sintassi

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

Parametri

[out] ppdwProtocols

Puntatore a una matrice di protocolli supportati. Per questa versione di Windows Media Gestione dispositivi, si tratta di una matrice DWORD a singolo elemento contenente il valore SAC_PROTOCOL_V1.

[out] pdwProtocolCount

Puntatore a un DWORD contenente il numero di protocolli restituiti in ppdwProtocols. Il numero è sempre 1 per questa versione.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Questo metodo viene implementato da un provider di servizi e non viene mai chiamato da un'applicazione.

Esempio

Il metodo seguente illustra l'implementazione di un provider di servizi del metodo SACGetProtocols . A tale scopo, chiamare CSecureChannelServer::SACGetProtocols nel membro CSecureChannelServer privato.


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