Método IMbnConnectionProfileManager::GetConnectionProfiles (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.

Obtém uma lista de perfis de conexão associados ao dispositivo.

Sintaxe

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

Parâmetros

[in] mbnInterface

Um IMbnInterface que representa o dispositivo para o qual a solicitação de perfil se aplica. Se for NULL, a função retornará todos os perfis presentes no sistema.

[out, retval] connectionProfiles

Uma matriz de interfaces IMbnConnectionProfile que representam todos os perfis de conexão disponíveis para o dispositivo. Se esse método retornar algo diferente de S_OK, o ponteiro da matriz será NULL, caso contrário, o aplicativo de chamada deverá liberar a memória alocada chamando SafeArrayDestroy.

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.
E_HANDLE	A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
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_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução neste sistema.

Comentários

Quando essa operação é chamada para um dispositivo específico, ela retorna uma lista de perfis que têm a mesma ID de assinante relatada atualmente pelo dispositivo. O método GetSubscriberInformation de IMbnInterface pode ser usado para obter a ID do assinante associada à interface .

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).

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

Confira também

IMbnConnectionProfileManager