Método IMbnInterface::GetSubscriberInformation (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 as informações do assinante.

Sintaxe

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

Parâmetros

[out, retval] subscriberInformation

Um ponteiro para o endereço de uma interface IMbnSubscriberInformation que contém informações de assinante para o dispositivo. Se esse método retornar qualquer valor diferente de S_OK, esse parâmetro 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. subscriberInformation contém uma interface válida.
E_PENDING	As informações não estão disponíveis. O serviço de Banda Larga Móvel está atualmente investigando as informações. O aplicativo de chamada pode ser notificado quando as informações estiverem disponíveis registrando-se para o método OnSubscriberInformationChange de IMbnInterfaceEvents.

Comentários

O método GetSubscriberInformation retorna as informações relacionadas ao assinante, incluindo id do assinante, número de cartão de circuito internacional do SIM e números de telefone associados a essa interface.

Quando esse método for chamado de um aplicativo da Windows Store com privilégios de operadora móvel, ele retornará apenas o circuito sim internacional cartão número definido pela propriedade SimIccID.

Alguns dos valores retornados nas informações do assinante são preenchidos somente quando o estado pronto, conforme relatado pelo método GetReadyState de IMbnInterface , é MBN_READY_STATE_INITIALIZED. Sempre que houver uma alteração nas informações do assinante associadas ao dispositivo de Banda Larga Móvel, o serviço de Banda Larga Móvel notificará os aplicativos registrados chamando o método OnSubscriberInformationChange de IMbnInterfaceEvents.

As informações do assinante de um dispositivo não serão alteradas depois que o estado pronto do dispositivo for MBN_READY_STATE_INITIALIZED.

Requisitos

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

IMbnInterface