Compartilhar via


Função WSCGetProviderInfo (ws2spi.h)

**Observação** Os provedores de serviços em camadas foram preteridos. Começando com Windows 8 e Windows Server 2012, use a Plataforma de Filtragem do Windows.
 
A função **WSCGetProviderInfo** recupera os dados associados a uma classe de informações para um LSP (provedor de serviços em camadas).

Sintaxe

int WSCGetProviderInfo(
  [in]      LPGUID                 lpProviderId,
  [in]      WSC_PROVIDER_INFO_TYPE InfoType,
  [out]     PBYTE                  Info,
  [in, out] size_t                 *InfoSize,
  [in]      DWORD                  Flags,
  [out]     LPINT                  lpErrno
);

Parâmetros

[in] lpProviderId

Um ponteiro para um GUID (identificador global exclusivo) para o provedor.

[in] InfoType

A classe de informações solicitada para essa entrada de protocolo LSP.

[out] Info

Um ponteiro para um buffer para receber os dados da classe de informações para a entrada de protocolo LSP solicitada. Se esse parâmetro for NULL, WSCGetProviderInfo retornará falha e o tamanho necessário para esse buffer será retornado no parâmetro InfoSize .

[in, out] InfoSize

O tamanho, em bytes, do buffer apontado pelo parâmetro Info . Se o parâmetro Info for NULL, WSCGetProviderInfo retornará falha e o parâmetro InfoSize receberá o tamanho do buffer necessário.

[in] Flags

Os sinalizadores usados para modificar o comportamento da chamada de função WSCGetProviderInfo .

[out] lpErrno

Um ponteiro para o código de erro se a função falhar.

Retornar valor

Se nenhum erro ocorrer, WSCGetProviderInfo retornará ERROR_SUCCESS (zero). Caso contrário, ele retornará SOCKET_ERROR e um código de erro específico será retornado no parâmetro lpErrno .

Código do erro Significado
ERROR_CALL_NOT_IMPLEMENTED
A chamada não é implementada. Esse erro será retornado se **ProviderInfoAudit** for especificado no parâmetro InfoType .
WSAEFAULT
Um ou mais argumentos não estão em uma parte válida do espaço de endereço do usuário.
WSAEINVAL
Um ou mais argumentos são inválidos.
WSAEINVALIDPROVIDER
Não foi possível encontrar a entrada de protocolo para o lpProviderId especificado.
WSANO_RECOVERY
Ocorreu um erro não detectável. Esse erro é retornado sob várias condições, incluindo o seguinte: o usuário não tem os privilégios administrativos necessários para acessar o registro winsock ou ocorreu uma falha ao abrir uma entrada de catálogo do Winsock.
WSA_NOT_ENOUGH_MEMORY
Memória insuficiente disponível. Esse erro é retornado quando não há memória suficiente para alocar uma nova entrada de catálogo.

Comentários

WSCGetProviderInfo é usado para recuperar dados de classe de informações para um provedor de serviços em camadas. Quando o parâmetro InfoType é definido como ProviderInfoLspCategories, em êxito WSCGetProviderInfo retorna com o parâmetro Info definido com sinalizadores de categoria LSP apropriados implementados pelo LSP.

Winsock 2 acomoda protocolos em camadas. Um protocolo em camadas é aquele que implementa apenas funções de comunicação de nível mais alto, enquanto depende de uma pilha de transporte subjacente para a troca real de dados com um ponto de extremidade remoto. Um exemplo de um protocolo em camadas ou um provedor de serviços em camadas seria uma camada de segurança que adiciona protocolo ao processo de estabelecimento de conexão para executar a autenticação e estabelecer um esquema de criptografia mutuamente acordado. Esse protocolo de segurança geralmente exigiria os serviços de um protocolo de transporte confiável subjacente, como TCP ou SPX. O termo protocolo base refere-se a um protocolo como TCP ou SPX que é capaz de executar comunicações de dados com um ponto de extremidade remoto. O termo protocolo em camadas é usado para descrever um protocolo que não pode ficar sozinho. Em seguida, uma cadeia de protocolos seria definida como um ou mais protocolos em camadas amarrados e ancorados por um protocolo base. Um protocolo base tem o membro ChainLen da estrutura WSAProtocol_Info definido como BASE_PROTOCOL que é definido como 1. Um protocolo em camadas tem o membro ChainLen da estrutura WSAPROTOCOL_INFO definido como LAYERED_PROTOCOL que é definido como zero. Uma cadeia de protocolos tem o membro ChainLen da estrutura WSAPROTOCOL_INFO definido como maior que 1.

Durante a inicialização do LSP, o LSP deve fornecer ponteiros para várias funções de SPI winsock. Essas funções serão chamadas durante o processamento normal pela camada diretamente acima do LSP (outro LSP ou Ws2_32.DLL).

Um LSP que implementa um IFS (sistema de arquivos) instalável pode optar seletivamente por fornecer ponteiros para funções que são implementadas por si só ou passar de volta os ponteiros fornecidos pela camada diretamente abaixo do LSP. LSPs não IFS, porque eles fornecem seus próprios identificadores, devem implementar todas as funções de SPI winsock. Isso ocorre porque cada SPI exigirá que o LSP mapeie todas as alças de soquete criadas para o identificador de soquete do provedor inferior (outro LSP ou o protocolo base).

No entanto, todos os LSPs executam seu trabalho específico fazendo processamento extra apenas em um subconjunto das funções DE SPI winsock.

É possível definir categorias LSP com base no subconjunto de funções SPI que um LSP implementa e a natureza do processamento extra executado para cada uma dessas funções.

Ao classificar LSPs, bem como classificar aplicativos que usam soquetes Winsock, torna-se possível determinar seletivamente se um LSP deve estar envolvido em um determinado processo em runtime.

No Windows Vista e posteriores, um LSP pode ser classificado com base em como ele interage com chamadas e dados do Windows Sockets. Uma categoria LSP é um grupo identificável de comportamentos em um subconjunto de funções WINSock SPI. Por exemplo, um filtro de conteúdo HTTP seria categorizado como um inspetor de dados (a categoria LSP_INSPECTOR). A categoria LSP_INSPECTOR inspecionará (mas não alterará) parâmetros para funções SPI de transferência de dados. Um aplicativo pode consultar a categoria de um LSP e optar por não carregar o LSP com base na categoria LSP e no conjunto de categorias LSP permitidas pelo aplicativo.

A tabela a seguir lista categorias nas quais um LSP pode ser classificado.

Categoria LSP Descrição
**LSP_CRYPTO_COMPRESS** O LSP é um provedor de criptografia ou compactação de dados.
**LSP_FIREWALL** O LSP é um provedor de firewall.
**LSP_LOCAL_CACHE** O LSP é um provedor de cache local.
**LSP_INBOUND_MODIFY** O LSP modifica os dados de entrada.
**LSP_INSPECTOR** O LSP inspeciona ou filtra dados.
**LSP_OUTBOUND_MODIFY** O LSP modifica os dados de saída.
**LSP_PROXY** O LSP atua como um proxy e redireciona pacotes.
**LSP_REDIRECTOR** O LSP é um redirecionador de rede.
**LSP_SYSTEM** O LSP é aceitável para uso em serviços e processos do sistema.
 

Um LSP pode pertencer a mais de uma categoria. Por exemplo, um LSP de firewall/segurança pode pertencer às categorias inspetor (LSP_INSPECTOR) e firewall (LSP_FIREWALL).

Se um LSP não tiver um conjunto de categorias, ele será considerado na categoria Todos os Outros. Essa categoria LSP não será carregada em serviços ou processos do sistema (por exemplo, lsass, winlogon e muitos processos svchost).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2spi.h
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

Categorizando aplicativos e provedores de serviços em camadas

Wsaprotocol_info

WSCGetApplicationCategory

WSCSetApplicationCategory

WSCSetProviderInfo

WSC_PROVIDER_INFO_TYPE