Método IMbnMultiCarrierEvents::OnSetHomeProviderComplete (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.

Esse método de notificação é chamado pelo serviço de Banda Larga Móvel para indicar a conclusão de uma operação SetHomeProvider .

Sintaxe

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parâmetros

[in] mbnInterface

Um objeto IMbnMultiCarrier que representa a operação SetHomeProvider do dispositivo de banda larga móvel.

[in] requestID

A ID da solicitação atribuída pelo serviço de Banda Larga Móvel à operação SetHomeProvider .

[in] status

Um código status que indica o resultado de SetHomeProvider.

Valor	Significado
S_OK	A operação foi bem-sucedida.
E_MBN_PROVIDER_NOT_VISIBLE	O provedor solicitado não está visível.
E_INVALIDARG	Entrada inválida no modo de registro, a ID do provedor fornecida como entrada é maior que o comprimento máximo de 7 caracteres ou a classe de dados fornecida é inválida. O serviço de Banda Larga Móvel não enviará a solicitação ao dispositivo quando argumentos inválidos forem fornecidos na entrada. No modo de registro manual, isso indica que o provedor solicitado é proibido.
E_FAIL	Não foi possível concluir a operação. Mais informações estão disponíveis no código de erro de rede.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	A operação não é compatível com o dispositivo. Isso pode ser retornado por dispositivos que não dão suporte a várias operadoras.

Retornar valor

Esse método deve retornar S_OK.

Comentários

Se status for S_OK, o provedor inicial da interface foi definido com êxito para o novo provedor por SetHomeProvider. Caso contrário, o provedor inicial original não será alterado e os estados anteriores, como conexão, serviço de pacote etc, da interface permanecerão inalterados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [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

IMbnMultiCarrierEvents