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

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

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 referenciar o adaptador principal de LAN sem fio físico (WLAN). Esse valor de identificador foi recebido como o parâmetro hDot11SvcHandle por meio de uma chamada anterior para a função Dot11ExtIhvInitAdapter manipulador IHV.

[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ásico. Esse valor de identificador foi recebido como o parâmetro hConnectSession por meio de uma chamada anterior para o função Dot11ExtIhvPerformPreAssociate 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.

Valor de retorno

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.

Observações

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, ele deverá fazê-lo antes de chamar o função Dot11ExtIhvPerformPreAssociate 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
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wlanihv.h (inclua Wlanihv.h)

Consulte também

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY

Partilhar via