Compartilhar via

Método IMbnRegistration::SetRegisterMode (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.

Define o modo de registro para o dispositivo.

Sintaxe

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

Parâmetros

[in] registerMode

Um valor MBN_REGISTER_MODE que especifica o novo modo de registro.

[in] providerID

Uma cadeia de caracteres que especifica a ID do provedor de rede para o qual registrar. Deve ser NULL quando registerMode é MBN_REGISTER_MODE_AUTOMATIC.

[in] dataClass

Uma combinação bit a bit de valores or MBN_DATA_CLASS que especificam as tecnologias de acesso a dados preferenciais para a conexão. O serviço de Banda Larga Móvel registrará a tecnologia de classe de dados mais alta disponível nesta lista. Se nenhuma classe de dados dessa lista puder ser registrada, o serviço de Banda Larga Móvel se registrará na melhor classe de dados disponível.

[out] requestID

Uma ID de solicitação definida pelo serviço de Banda Larga Móvel para identificar essa solicitação assíncrona.

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.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 O serviço de Banda Larga Móvel não está em execução neste sistema.
E_HANDLE
 A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Já existe uma conexão de rede ativa. O modo de registro não pode ser alterado enquanto houver uma conexão de dados já estabelecida. O aplicativo de chamada 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.

Comentários

O método SetRegisterMode pode ser usado para definir um dispositivo no modo de seleção de rede automático ou manual. Para o modo de registro manual, a ID de rede à qual o dispositivo deve se registrar é fornecida em providerID.

O suporte para o modo de registro manual é opcional e o aplicativo deve verificar se o dispositivo dá suporte ao registro manual verificando se há MBN_CTRL_CAPS_REG_MANUAL no parâmetro interfaceCaps preenchido pelo método GetInterfaceCapability de IMbnInterface. Se um aplicativo definir o modo de registro manual e não tiver suporte do dispositivo, essa chamada retornará HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED).

SetRegisterMode é assíncrono e retornará imediatamente. Se não houver nenhum erro, ao concluir a operação, o serviço de Banda Larga Móvel chamará o método OnSetRegisterModeComplete de IMbnRegistrationEvents.

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

IMbnRegistration

  • Last updated on