Método IMbnConnectionProfile::UpdateProfile (mbnapi.h)

Importante

A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.

Atualizações o conteúdo do perfil.

Sintaxe

HRESULT UpdateProfile(
  [in] LPCWSTR strProfile
);

Parâmetros

[in] strProfile

Uma cadeia de caracteres que contém os dados de perfil em formato XML em conformidade com a Referência de Esquema de Perfil de Banda Larga Móvel.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_HANDLE	O perfil é inválido e provavelmente foi removido do sistema.
HRESULT_FROM_WIN32(ERROR _NOT_FOUND)	O perfil é inválido e provavelmente foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Os dados de perfil especificam um arquivo de ícone que não pode ser encontrado no local indicado.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução neste sistema.

Comentários

Os dados fornecidos por esse método estão em conformidade com a Referência de Esquema de Perfil de Banda Larga Móvel.

Esse método deve ser chamado quando o dispositivo do perfil estiver presente no sistema.

Esta é uma operação síncrona. Se tiver êxito, o serviço de Banda Larga Móvel notificará o aplicativo de chamada chamando o método OnProfileUpdate da interface IMbnConnectionProfileEvents .

Requisitos

Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	mbnapi.h

Confira também

IMbnConnectionProfile