Função WSCInstallQOSTemplate (ws2spi.h)

  • Artigo

[ Essa função não tem suporte no Windows Vista e nas versões subsequentes do sistema operacional.]

A função WSCInstallQOSTemplate instala o modelo de QoS especificado no banco de dados de configuração do sistema.

Sintaxe

int WSCInstallQOSTemplate(
  [in] const LPGUID Guid,
  [in] LPWSABUF     QosName,
  [in] LPQOS        Qos
);

Parâmetros

[in] Guid

O GUID (identificador global exclusivo) para o provedor de QoS (qualidade de serviço).

[in] QosName

Um ponteiro para uma estrutura WSABUF que contém o nome QoS do modelo a ser instalado.

[in] Qos

Um ponteiro para uma estrutura QOS que especifica a qualidade das especificações de fluxo de serviço e quaisquer informações específicas do provedor para o modelo de QoS.

Retornar valor

Se a função WSCInstallQOSTemplate for bem-sucedida, o valor retornado será zero. Caso contrário, ele retornará um dos seguintes códigos de erro.

Código do erro Significado
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. Esse erro será retornado se o provedor de QoS especificado no parâmetro Guid for inválido ou o nome do modelo de QoS especificado no parâmetro QosName for inválido. Esse erro também será retornado se o conteúdo da estrutura de modelo especificada no parâmetro Qos for inválido ou incompleto.
WSAENOBUFS
 A memória não pode ser alocada para buffers.
WSANO_RECOVERY
 Ocorreu um erro não recuperável. Esse erro é retornado sob várias condições, incluindo o seguinte: o provedor já está instalado, o usuário não tem os privilégios administrativos necessários para gravar no registro winsock ou ocorreu uma falha ao criar ou instalar uma entrada de catálogo.
WSASYSCALLFAILURE
 Falha em uma chamada do sistema que nunca deve falhar.
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

A função WSCInstallQOSTemplate não tem suporte no Windows Vista e posterior. Se essa função for chamada no Windows Vista, e o erro for retornado.

A função WSCInstallQOSTemplate instala um modelo de QoS, com base em um nome QoS. O chamador da função WSCInstallQOSTemplate deve ter direitos administrativos apropriados para que a chamada seja bem-sucedida.

A estrutura QOS que contém as configurações de QoS pode ser recuperada posteriormente chamando a função WSPGetQOSByName e passando o nome QoS associado.

A função WSCInstallQOSTemplate instala um modelo de QoS nomeado que contém o
Estrutura QOS especificada no parâmetro Qos . Se um modelo de QoS já existir com o nome QoS especificado no parâmetro Qosname , as configurações especificadas no parâmetro Qos substituirão as configurações do modelo existente.

Se o parâmetro Guid for definido como NULL, o modelo de QOS instalado se aplicará a todos os provedores de serviços. Se o parâmetro Guid não for NULL, o modelo de QoS instalado se aplicará somente ao provedor indicado pelo parâmetro Guid .

As configurações de modelo de QoS são armazenadas no armazenamento não volátil, portanto, chamadas subsequentes para a função WSAGetQOSByName com o mesmo nome QoS especificado no parâmetro lpQOSName retornam a mesma estrutura QOS passada para a função WSCInstallQOSTemplate .

O Windows Sockets 2 inclui um conjunto base de modelos de QoS. Você pode substituir e substituir qualquer um desses modelos de QoS ou alterar um modelo de QoS existente simplesmente instalando um novo modelo com o nome existente. Você não precisa excluir um modelo existente antes de substituí-lo ou modificá-lo. Não é possível excluir o conjunto base de modelos nomeados por QoS incluídos no Windows Sockets 2. No entanto, você pode excluir modelos adicionados posteriormente, talvez por outros provedores de serviços.

O parâmetro Qos aponta para uma estrutura QOS que pode incluir um buffer que contém configurações específicas do provedor no membro ProviderSpecific da estrutura QOS . Todas as configurações específicas do provedor são armazenadas com a estrutura básica do QOS e são retornadas em chamadas subsequentes para a função WSAGetQOSByName .

O membro ProviderSpecific da estrutura QOS pode ser definido mesmo se o parâmetro Guid estiver definido como NULL para instalar um modelo de QoS global para todos os provedores de serviços. Observe que essa prática pode levar um provedor de serviços a ignorar o membro ProviderSpecific da estrutura QOS se o provedor de serviços não reconhecer seu conteúdo. O uso recomendado da função WSCInstallQOSTemplate é incluir configurações específicas do provedor no membro ProviderSpecific da estrutura QOS somente se o modelo nomeado estiver sendo instalado em um provedor de serviços específico (o parâmetro Guid não é NULL).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2spi.h

Confira também

QOS

WSABUF

WSPGetQOSByName