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.
Método de notificação chamado pelo serviço de Banda Larga Móvel para indicar que concluiu uma operação de registro definida.
Sintaxe
HRESULT OnSetRegisterModeComplete(
[in] IMbnRegistration *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parâmetros
[in] newInterface
Ponteiro para uma interface IMbnRegistration que representa o dispositivo aplicável. O aplicativo de manipulação pode usar essa interface para obter o estado de registro atual do dispositivo.
[in] requestID
A ID da solicitação atribuída pelo serviço de Banda Larga Móvel para acompanhar a operação de registro do conjunto.
[in] status
Um código status que indica o resultado da operação.
Um aplicativo de chamada pode esperar um dos valores possíveis.
| Valor |
Significado |
-
S_OK
|
A operação foi bem-sucedida.
|
-
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
|
Já existe uma conexão de rede ativa. O modo de registro não pode ser alterado quando há uma conexão de dados já estabelecida. O aplicativo deve primeiro desconectar a conexão e, em seguida, tentar alterar o modo de registro. Se o dispositivo já estiver no modo solicitado e conectado ao provedor solicitado, o código de retorno será S_OK.
|
-
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 ao modo de registro solicitado. Por exemplo, um dispositivo CDMA retornará esse erro quando solicitado a alternar para o modo de registro manual.
|
-
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.
|
-
E_INVALIDARG
|
Entrada de modo de registro inválida ou a ID do provedor fornecida, pois a 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 para o dispositivo quando argumentos inválidos forem fornecidos na entrada.
No modo de registro manual, isso indica que o provedor solicitado é proibido.
|
-
E_MBN_PIN_REQUIRED
|
Um PIN é necessário para que a operação seja concluída.
|
-
E_MBN_SERVICE_NOT_ACTIVATED
|
A assinatura do serviço de rede expirou.
|
-
E_MBN_PROVIDER_NOT_VISIBLE
|
Isso ocorre somente ao alternar para o modo de registro manual. A opção foi bem-sucedida, mas o provedor solicitado não está visível. O dispositivo será registrado no provedor solicitado quando estiver visível.
|
Valor retornado
Esse método deve retornar S_OK.
Requisitos
| |
|
|
Cliente mínimo com suporte |
Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
|
Servidor mínimo com suporte |
Nenhum compatível |
|
Plataforma de Destino |
Windows |
|
Cabeçalho |
mbnapi.h |
Confira também
IMbnRegistrationEvents