Método IDot11AdHocManager::CommitCreatedNetwork (adhoc.h)

Artigo
08/22/2023

Inicializa uma rede criada e, opcionalmente, confirma o perfil da rede para o repositório de perfil. A rede deve ser criada usando CreateNetwork antes de chamar CommitCreatedNetwork.

Sintaxe

HRESULT CommitCreatedNetwork(
  [in] IDot11AdHocNetwork *pIAdHoc,
  [in] BOOLEAN            fSaveProfile,
  [in] BOOLEAN            fMakeSavedProfileUserSpecific
);

Parâmetros

[in] pIAdHoc

Um ponteiro para uma interface IDot11AdHocNetwork que especifica a rede a ser inicializada e confirmada.

[in] fSaveProfile

Um parâmetro opcional que especifica se um perfil sem fio deve ser salvo. Se TRUE, o perfil será salvo no repositório de perfil. Depois que um perfil for salvo, o usuário poderá modificar o perfil usando a interface do usuário Gerenciar Rede Sem Fio . Os perfis também podem ser modificados usando as funções wi-fi nativas.

Salvar um perfil modifica a assinatura de rede retornada por IDot11AdHocNetwork::GetSignature.

[in] fMakeSavedProfileUserSpecific

Um parâmetro opcional que especifica se o perfil a ser salvo é um perfil de todos os usuários. Se definido como TRUE, o perfil será específico para o usuário atual. Se definido como FALSE, o perfil será um perfil de todos os usuários e poderá ser usado por qualquer usuário conectado ao computador. Esse parâmetro será ignorado se fSaveProfile for FALSE.

Por padrão, somente os membros do grupo Administradores podem persistir um perfil de todos os usuários. Essas configurações de segurança podem ser alteradas usando a função WlanSetSecuritySettings . Seu aplicativo deve ser iniciado por um usuário com privilégios suficientes para que um perfil de todos os usuários seja mantido com êxito.

Se o aplicativo estiver em execução em uma janela da Área de Trabalho Remota, você só poderá salvar um perfil de todos os usuários. Perfis específicos do usuário não podem ser salvos de um aplicativo em execução remotamente.

Retornar valor

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_FAIL	O método falhou.
E_INVALIDARG	Um dos parâmetros é inválido.
E_NOINTERFACE	Não há suporte para uma interface especificada.
E_OUTOFMEMORY	O método não pôde alocar a memória necessária para executar essa operação.
E_POINTER	Um ponteiro passado como um parâmetro não é válido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	adhoc.h

Confira também

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork

Compartilhar via