Função de retorno de chamada LPWSPGETQOSBYNAME (ws2spi.h)

  • Artigo

A função WSPGetQOSByName inicializa uma estrutura QOS com base em um modelo nomeado ou recupera uma enumeração dos nomes de modelo disponíveis.

Sintaxe

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

BOOL Lpwspgetqosbyname(
  [in]      SOCKET s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS lpQOS,
  [out]     LPINT lpErrno
)
{...}

Parâmetros

[in] s

Descritor que identifica um soquete.

[in, out] lpQOSName

Especifica o nome do modelo do QOS ou fornece um buffer para recuperar uma enumeração dos nomes de modelo disponíveis.

[out] lpQOS

Ponteiro para a estrutura QOS a ser preenchida.

[out] lpErrno

Ponteiro para o código de erro.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE. Se a função falhar, o valor retornado será FALSE e um código de erro específico estará disponível no lpErrno.

Código do Erro Significado
WSAENETDOWN
 O subsistema de rede falhou.
WSAENOTSOCK
 O descritor não é um soquete.
WSAENOTSOCK
 O argumento lpQOS não é uma parte válida do espaço de endereço do usuário ou o comprimento do buffer para lpQOS é muito pequeno.
WSAEINVAL
 O nome do modelo de QOS especificado é inválido.

Comentários

Os clientes podem usar WSPGetQOSByName para inicializar uma estrutura QOS para um conjunto de valores conhecidos apropriados para uma classe de serviço ou tipo de mídia específico. Esses valores são armazenados em um modelo referenciado por um nome conhecido. O cliente pode recuperar esses valores definindo o membro buf do WSABUF indicado por lpQOSName para apontar para uma cadeia de caracteres Unicode de comprimento diferente de zero especificando um nome de modelo. Nesse caso, o uso de lpQOSName é somente IN e os resultados são retornados por meio do lpQOS.

Como alternativa, o cliente pode usar LPWSPGetQOSByName para recuperar uma enumeração de nomes de modelo disponíveis. O cliente pode fazer isso definindo o membro buf do WSABUF indicado por lpQOSName como uma cadeia de caracteres Unicode terminada em nulo de comprimento zero. Nesse caso, o buffer indicado por buf é substituído por uma sequência de quantas cadeias de caracteres de nome de modelo Unicode terminadas em nulo estão disponíveis até o número de bytes disponíveis no buf , conforme indicado pelo membro len do WSABUF indicado por lpQOSName. A lista de nomes em si é encerrada por uma cadeia de caracteres de nome Unicode de comprimento zero. Quando LPWSPGetQOSByName é usado para recuperar nomes de modelo, o parâmetro lpQOS é ignorado.

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]
Cabeçalho ws2spi.h

Confira também

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt