Méthode IComponentAuthenticate ::SACGetProtocols (mswmdm.h)

Article
03/04/2024

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 Gestionnaire de périphériques, il s’agit d’un tableau DWORD à élément unique 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 retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques 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 par un fournisseur de services de la méthode SACGetProtocols . Pour ce faire, il appelle CSecureChannelServer ::SACGetProtocols sur son membre CSecureChannelServer privé.


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