WSK_TRANSPORT_LIST_QUERY

Um aplicativo WSK usa a operação de controle do cliente WSK_TRANSPORT_LIST_QUERY para recuperar uma lista de transportes de rede disponíveis que podem ser especificados ao criar um novo soquete.

Para recuperar uma lista de transportes de rede disponíveis, um aplicativo WSK chama a função WskControlClient com os parâmetros a seguir.

Parâmetro	Valor
ControlCode	WSK_TRANSPORT_LIST_QUERY
InputSize	0
Inputbuffer	NULL
OutputSize	O tamanho, em bytes, da matriz de estruturas que é apontada pelo parâmetro OutputBuffer
OutputBuffer	Um ponteiro para uma matriz de estruturas de WSK_TRANSPORT que recebe a lista de transportes de rede disponíveis
OutputSizeReturned	Um ponteiro para uma variável do tipo SIZE_T que recebe o número de bytes de dados copiados para a matriz de estruturas apontadas pelo parâmetro OutputBuffer
Irp	NULL

Um aplicativo WSK pode especificar zero no parâmetro OutputSize e NULL no parâmetro OutputBuffer para determinar o tamanho da matriz de estruturas de WSK_TRANSPORT , em bytes, que é necessário para conter a lista completa de transportes de rede disponíveis. Nessa situação, a chamada para a função WskControlClient retorna STATUS_BUFFER_OVERFLOW e a variável apontada pelo parâmetro OutputSizeReturned contém o tamanho do buffer necessário. Em seguida, o aplicativo pode alocar um buffer grande o suficiente para conter a lista completa de transportes de rede disponíveis e pode chamar a função WskControlClient uma segunda vez, especificando os parâmetros mostrados na tabela anterior.

O parâmetro Irp deve ser NULL para essa operação de controle do cliente.

Requisitos

Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Wsk.h (inclua Wsk.h)