Compartilhar via

Função WZCQueryInterface

  • Artigo

[O WZCQueryInterface não tem mais suporte do Windows Vista e do Windows Server 2008. Em vez disso, use a função WlanQueryInterface . Para obter mais informações, consulte Sobre a API wi-fi nativa. ]

A função WZCQueryInterface fornece informações detalhadas para uma interface lan sem fio gerenciada pelo serviço de Configuração Zero Sem Fio.

Fornece informações detalhadas para uma determinada interface.

Sintaxe

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ PINTF_ENTRY pIntf,
  _Out_   LPDWORD     pdwOutFlags
);

Parâmetros

pSrvAddr [in]

Um ponteiro para uma cadeia de caracteres que contém o nome do computador no qual executar essa função. Se esse parâmetro for NULL, o serviço de Configuração Sem Fio Zero será consultado no computador local.

Se o parâmetro pSrvAddr especificado for um computador remoto, o computador remoto deverá dar suporte a chamadas RPC remotas.

dwInFlags [in]

Os campos a serem consultados. Essa é uma máscara de bits que pode conter qualquer combinação dos sinalizadores a seguir.

Valor Significado
INTF_DYNFLAGS
0x00000010
 Retorne o valor para o membro dwDynFlags na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
INTF_DESCR
0x00010000
 Retorne o valor para o membro wszDescr na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
INTF_NDISMEDIA
0x00020000
 Retornar os valores para os membros ulMediaState, ulMediaType e ulPhysicalMediaType na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
INTF_PREFLIST
0x00040000
 Retorne a lista preferencial de redes no membro rdStSSIDList da estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
INTF_CAPABILITIES
0x00080000
 Retorne os valores para os membros dwCapabilities e rdNicCapabilities na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
INTF_INFRAMODE
0x00200000
 Retornar o valor do membro nInfraMode na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro nInfraMode é válido apenas em alguns estados de contexto de interface.
INTF_AUTHMODE
0x00400000
 Retorne o valor do membro nAuthMode na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro nAuthMode é válido apenas em alguns estados de contexto de interface.
INTF_WEPSTATUS
0x00800000
 Retorne o valor do membro nWepStatus na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro nWepStatus é válido apenas em alguns estados de contexto de interface.
INTF_SSID
0x01000000
 Retornar o valor do membro rdSSID na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro rdSSID é válido apenas em alguns estados de contexto de interface.
INTF_BSSID
0x02000000
 Retorne o valor do membro rdBSSID na estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro rdBSSID é válido apenas em alguns estados de contexto de interface.
INTF_BSSIDLIST
0x04000000
 Retorne a lista visível de redes no membro rdBSSIDList da estrutura INTF_ENTRY apontada pelo parâmetro pIntf .
O membro rdBSSIDList é válido apenas em alguns estados de contexto de interface.

 

pIntf [in, out]

Na entrada, um ponteiro para a chave da interface a ser consultada. Na saída, um ponteiro para os dados de interface solicitados. Esse parâmetro é um ponteiro para uma estrutura INTF_ENTRY .

pdwOutFlags [out]

Um conjunto de campos recuperados com êxito.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno Descrição
ERROR_ARENA_TRASHED
 Os blocos de controle de armazenamento foram destruídos. Esse erro será retornado se o serviço De configuração zero sem fio não tiver inicializado objetos internos.
ERROR_FILE_NOT_FOUND
 O sistema não pode encontrar o arquivo especificado. Esse erro será retornado se o GUID no membro wszGuid da estrutura INTF_ENTRY apontada pelo parâmetro pIntf não corresponder a nenhuma das interfaces lan sem fio no computador local.
ERROR_INVALID_PARAMETER
 Um parâmetro está incorreto. Esse erro será retornado se o parâmetro pIntf for NULL. Esse erro será retornado se o membro wszGuid da estrutura INTF_ENTRY apontada pelo parâmetro pIntf for NULL.
ERROR_NOT_ENOUGH_MEMORY
 Não há memória suficiente disponível para processar essa solicitação e alocar memória para os resultados da consulta.
RPC_STATUS
 Vários códigos de erro.

 

Comentários

O membro wszGuid da estrutura de INTF_ENTRY apontada pelo parâmetro pIntf deve conter um GUID de interface para uma interface LAN sem fio. Uma lista de interfaces LAN sem fio pode ser recuperada chamando a função WZCEnumInterfaces .

Os seguintes membros da estrutura INTF_ENTRY apontada pelo pIntf devem ser definidos como 0 antes de uma chamada para a função WZCQueryInterface : rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList e rdCtrlData.

O serviço de Configuração Zero Sem Fio não atualiza automaticamente o estado da mídia, mesmo quando eventos conectados e desconectados da mídia são recebidos. Um aplicativo deve forçar uma atualização de estado de mídia chamando a função WZCRefreshInterface antes de chamar a função WZCQueryInterface se o estado de mídia do NDIS for solicitado (o bit INTF_NDISMEDIA será definido no parâmetro dwInFlags ).

Quando o parâmetro dwInFlags contém INTF_BSSIDLIST, a função WZCQueryInterface não define o dwOutFlags com INTF_BSSIDLIST se a lista visível de redes estiver vazia. Quando o parâmetro dwInFlags contém INTF_SSID, a função WZCQueryInterface não define o dwOutFlags com INTF_SSID se nenhum SSID estiver disponível.

Se a função WZCQueryInterface retornar ERROR_SUCCESS, o chamador deverá chamar a função LocalFree com o parâmetro pIntf para liberar os buffers internos alocados para os dados retornados depois que essas informações não forem mais necessárias. Isso libera os buffers usados pelos membros rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList e rdCtrlData da estrutura INTF_ENTRY apontada pelo parâmetro pIntf .

Observação

O arquivo de cabeçalho Wzcsapi.h e o arquivo de biblioteca de importação Wzcsapi.lib não estão disponíveis no SDK do Windows.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Fim do suporte ao cliente
 Windows XP com SP3
Fim do suporte ao servidor
 Windows Server 2003
Cabeçalho
Wzcsapi.h
Biblioteca
Wzcsapi.lib
DLL
Wzcsapi.dll

Confira também

INTF_ENTRY

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCRefreshInterface