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) |