IComponentAuthenticate ::SACGetProtocols, méthode (mswmdm.h)

Article
03/05/2025

La méthode SACGetProtocols est utilisée par un composant pour découvrir les protocoles d’authentification pris en charge par un autre composant.

Syntaxe

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

Paramètres

[out] ppdwProtocols

Pointeur vers un tableau de protocoles pris en charge. Pour cette version de Windows Media Device Manager, il s’agit d’un élément unique tableau DWORD contenant la valeur SAC_PROTOCOL_V1.

[out] pdwProtocolCount

Pointeur vers un DWORD contenant le nombre de protocoles retournés dans ppdwProtocols. Le nombre est toujours 1 pour cette version.

Valeur de retour

La méthode retourne une HRESULT. Toutes les méthodes d’interface dans Windows Media Device Manager peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur du Gestionnaire d’appareils Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Cette méthode est implémentée par un fournisseur de services et n’est jamais appelée par une application.

Exemples

La méthode suivante illustre l’implémentation d’un fournisseur de services de la méthode SACGetProtocols. Pour ce faire, appelez CSecureChannelServer ::SACGetProtocols sur son membre privé CSecureChannelServer.


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