Função WZCRefreshInterface
[Não há suporte para WZCRefreshInterface a partir do Windows Vista e do Windows Server 2008. Em vez disso, use a API wi-fi nativa, que fornece funcionalidade semelhante. Para obter mais informações, consulte Sobre a API wi-fi nativa.]
A função WZCRefreshInterface atualiza as informações da interface para uma interface lan sem fio específica.
Sintaxe
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ 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 Zero Sem Fio será chamado 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]
-
Um conjunto de campos a serem atualizados juntamente com ações de atualização específicas a serem executadas. Essa é uma máscara de bits que pode conter qualquer combinação dos sinalizadores a seguir.
Valor Significado - INTF_DESCR
- 0x00010000
Atualize a descrição da interface para uma interface LAN sem fio.
A descrição da interface atualizada pode ser recuperada chamando a função WZCQueryInterface com o INTF_DESCR bit definido no parâmetro dwInFlags . A descrição da interface é retornada no membro wszDescr da estrutura INTF_ENTRY apontada pelo parâmetro pIntf retornado pela função WZCQueryInterface .- INTF_NDISMEDIA
- 0x00020000
Atualize as informações de mídia do NDIS para uma interface lan sem fio.
As informações de mídia NDIS atualizadas podem ser recuperadas chamando a função WZCQueryInterface com o INTF_NDISMEDIA bit definido no parâmetro dwInFlags . As informações de mídia do NDIS são retornadas nos membros ulMediaState, ulMediaType e ulPhysicalMediaType da estrutura INTF_ENTRY apontada pelo parâmetro pIntf retornado pela função WZCQueryInterface .- INTF_ALL_OIDS
- 0xFFF00000
Atualize todos os OIDs do NDIS para uma interface lan sem fio. Essa opção atualiza a maioria dos dados para uma interface LAN sem fio.
As informações atualizadas podem ser recuperadas chamando a função WZCQueryInterface . -
pIntf [in]
-
Um ponteiro para uma estrutura INTF_ENTRY que contém a chave da interface a ser atualizada.
-
pdwOutFlags [out]
-
Um conjunto de campos que foram atualizados 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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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 .
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 |
|
| Biblioteca |
|
| DLL |
|
Confira também