Função WSCInstallQOSTemplate (ws2spi.h)
[ 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 |
|---|---|
| Um ou mais argumentos não estão em uma parte válida do espaço de endereço do usuário. | |
| 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. | |
| A memória não pode ser alocada para buffers. | |
| 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. | |
| Falha em uma chamada do sistema que nunca deve falhar. | |
| 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 |