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 |
|---|---|
|
O método foi concluído com sucesso. |
|
A interface é inválida, provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
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. |
|
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 |