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

Artículo
08/25/2023

Un componente usa el método SACGetProtocols para detectar los protocolos de autenticación admitidos por otro componente.

Sintaxis

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

Parámetros

[out] ppdwProtocols

Puntero a una matriz de protocolos admitidos. Para esta versión de Windows Media Administrador de dispositivos, es una matriz DWORD de un solo elemento que contiene el valor SAC_PROTOCOL_V1.

[out] pdwProtocolCount

Puntero a un DWORD que contiene el número de protocolos devueltos en ppdwProtocols. El número siempre es 1 para esta versión.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Un proveedor de servicios implementa este método y nunca lo llama una aplicación.

Ejemplos

El método siguiente muestra la implementación de un proveedor de servicios del método SACGetProtocols . Para ello, llama a CSecureChannelServer::SACGetProtocols en su miembro privado 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;
}