Método IMbnConnectionProfileManager::GetConnectionProfile (mbnapi.h)

Importante

A partir de 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.

Obtém um perfil de conexão específico associado ao dispositivo de Banda Larga Móvel fornecido.

Sintaxe

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

Parâmetros

[in] mbnInterface

Um IMbnInterface que representa o dispositivo para o qual a solicitação de perfil se aplica. Se mbnInterface for NULL, essa função retornará o perfil do nome especificado associado a qualquer dispositivo no sistema.

[in] profileName

Uma cadeia de caracteres terminada em nulo que contém o nome do perfil de conexão.

[out, retval] connectionProfile

Uma interface IMbnConnectionProfile que representa o perfil de conexão desejado. Se esse método retornar algo diferente de S_OK, isso será NULL.

Retornar valor

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	A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Um perfil com o nome fornecido não existe.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	O dispositivo não está pronto. Não é possível obter a ID do assinante porque o dispositivo não está MBN_READY_STATE_INITIALIZED.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Um perfil com o nome fornecido não existe.

Comentários

Um perfil de conexão está associado à ID do assinante do dispositivo. Para dispositivos GSM, a ID do assinante é a IMSI (Identidade Internacional do Assinante Móvel) do SIM. Para dispositivos CDMA, é a cadeia de caracteres MIN (Número de Identificação Móvel) ou a cadeia de caracteres IRM (International Roaming MIN).

Se um novo perfil tiver sido criado usando CreateConnectionProfile, o chamador deverá aguardar o evento OnConnectionProfileArrival ser recebido antes de chamar GetConnectionProfile com o nome do novo perfil; caso contrário, a chamada à API GetConnectionProfile poderá falhar com HRESULT_FROM_WIN32(ERROR_NOT_FOUND).

Requisitos

Requisito	Valor
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

IMbnConnectionProfileManager