Método IMbnConnectionProfileManager::CreateConnectionProfile (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.
Cria um novo perfil de conexão para o dispositivo.
Sintaxe
HRESULT CreateConnectionProfile(
[in] LPCWSTR xmlProfile
);
Parâmetros
[in] xmlProfile
Uma cadeia de caracteres terminada em nulo 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 |
|---|---|
|
O método foi concluído com sucesso. |
|
Já existe um perfil com o nome fornecido. |
|
O perfil não está em conformidade com o esquema de perfil de Banda Larga Móvel. |
|
O local do arquivo de ícone passado no perfil não é válido ou não é acessível. |
|
O aplicativo de chamada especificou o sinalizador de perfil padrão nos dados XML, no entanto, o perfil padrão já existe para o dispositivo de Banda Larga Móvel. |
Comentários
Esta é uma operação síncrona. Se essa chamada de função for bem-sucedida, um novo perfil será criado e o serviço de Banda Larga Móvel chamará o método OnConnectionProfileArrival da interface IMbnConnectionProfileManagerEvents .
Se o local do arquivo de ícone for especificado nos dados do perfil, o serviço de Banda Larga Móvel copiará o arquivo de ícone do local especificado em seu próprio repositório. Uma consulta subsequente no objeto IMbnConnectionProfile para o local do arquivo de ícone retornará o local do arquivo em que o serviço de Banda Larga Móvel armazenou o arquivo de ícone. Sempre que um perfil é excluído do sistema, seu arquivo de ícone também é excluído do sistema. O arquivo de ícone deve estar no arquivo de formato de arquivo bmp com dimensões de 32 x 32 pixels.
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 |