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

Artigo
02/29/2024

O método SACGetProtocols é usado por um componente para descobrir os protocolos de autenticação compatíveis com outro componente.

Sintaxe

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

Parâmetros

[out] ppdwProtocols

Ponteiro para uma matriz de protocolos com suporte. Para esta versão do Windows Media Gerenciador de Dispositivos, é uma matriz DWORD de elemento único que contém o valor SAC_PROTOCOL_V1.

[out] pdwProtocolCount

Ponteiro para um DWORD que contém o número de protocolos retornados em ppdwProtocols. O número é sempre 1 para esta versão.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro do Windows Media Gerenciador de Dispositivos

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método é implementado por um provedor de serviços e nunca chamado por um aplicativo.

Exemplos

O método a seguir demonstra a implementação de um provedor de serviços do método SACGetProtocols . Ele faz isso chamando CSecureChannelServer::SACGetProtocols em seu membro CSecureChannelServer privado.


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