função de retorno de chamada DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES (wlanihv.h)

  • Artigo
Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.

A DLL de Extensões IHV chama a função Dot11ExtSetVirtualStationAPProperties para especificar a conexão de perfil IHV atual.

Sintaxe

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

Parâmetros

[in, optional] hDot11SvcHandle

Um identificador opcional usado pelo sistema operacional para fazer referência ao adaptador de WLAN (LAN sem fio) principal. Esse valor de identificador foi recebido como o parâmetro hDot11SvcHandle por meio de uma chamada anterior para a função Manipulador IHV Dot11ExtIhvInitAdapter .

[in, optional] hConnectSession

O identificador usado pelo sistema operacional para fazer referência à sessão de conexão atual com a rede BSS (conjunto de serviços) básica. Esse valor de identificador foi recebido como o parâmetro hConnectSession por meio de uma chamada anterior para o Dot11ExtIhvPerformPreAssociate Função manipulador IHV.

[in] dwNumProperties

O número de elementos na matriz de estruturas apontadas pelo parâmetro pProperties .

[in] pProperties

Um ponteiro para uma matriz de DOT11EXT_VIRTUAL_STATION_AP_PROPERTY estruturas que especificam as propriedades dos pontos de acesso (APs) que a estação virtual 802.11 está tentando hospedar na sessão de conexão atual.

pvReserved

Esse parâmetro é reservado para uso pelo sistema operacional e deve ser NULL.

Retornar valor

Se a chamada for bem-sucedida, a função retornará ERROR_SUCCESS. Caso contrário, ele retornará um código de erro definido em Winerror.h.

Comentários

Se a conexão de perfil IHV atual for um AP (ponto de acesso) e a DLL de Extensões IHV puder fornecer ao sistema operacional as configurações usadas pela AP, o sistema operacional poderá fornecer informações adicionais aos usuários que solicitam o serviço relacionado à AP do sistema operacional.

Se a DLL de Extensões IHV chamar Dot11ExtSetVirtualStationAPProperties, ela deverá fazer isso antes de chamar o Dot11ExtIhvPerformPreAssociate Função manipulador IHV. Se Dot11ExtSetVirtualStationAPProperties não for chamado antes da conclusão bem-sucedida da operação de pré-associação, o sistema operacional não fará suposições sobre a natureza do perfil IHV.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wlanihv.h (inclua Wlanihv.h)

Confira também

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY