estrutura MBN_CONTEXT (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.

A estrutura MBN_CONTEXT armazena informações sobre o contexto de conexão.

Sintaxe

typedef struct MBN_CONTEXT {
  ULONG             contextID;
  MBN_CONTEXT_TYPE  contextType;
  BSTR              accessString;
  BSTR              userName;
  BSTR              password;
  MBN_COMPRESSION   compression;
  MBN_AUTH_PROTOCOL authType;
} MBN_CONTEXT;

Membros

contextID

Contém o identificador exclusivo para esse contexto. Isso representa o índice de contexto no dispositivo ou na memória SIM. Se estiver definido como MBN_CONTEXT_ID_APPEND, o dispositivo encontrará o índice apropriado para armazenar o contexto.

contextType

Um valor MBN_CONTEXT_TYPE que especifica o tipo de contexto. Um aplicativo pode usar esse membro para modificar o contexto armazenado em um índice específico usando o método SetProvisionedContext de IMbnConnectionContext.

accessString

Contém informações de acesso específicas da conexão. Em redes GSM, esse seria um APN (nome de ponto de acesso), como "data.thephone-company.com". Em redes CDMA, esse pode ser um código de discagem especial, como "#777" ou um NAI (Identificador de Acesso à Rede), como "somebody@thephone-company.com".

Essa cadeia de caracteres não deve exceder MBN_ACCESSSTRING_LEN caracteres. Para obter a definição de MBN_ACCESSTRING_LEN, consulte MBN_CONTEXT_CONSTANTS. Essa cadeia de caracteres pode estar vazia. O aplicativo de chamada deve liberar essa cadeia de caracteres chamando SysFreeString.

userName

Contém o nome de usuário usado para autenticação.

A cadeia de caracteres não deve exceder MBN_USERNAME_LEN caracteres. O aplicativo de chamada deve liberar essa cadeia de caracteres chamando SysFreeString. Para obter a definição de MBN_USERNAME_LEN, consulte MBN_CONTEXT_CONSTANTS. O aplicativo de chamada deve liberar essa cadeia de caracteres chamando SysFreeString.

password

Contém a senha usada para autenticação.

A cadeia de caracteres não deve exceder MBN_PASSWORD_LEN caracteres. Essa cadeia de caracteres pode estar vazia. Para obter a definição de MBN_PASSWORD_LEN, consulte MBN_CONTEXT_CONSTANTS. O aplicativo de chamada deve liberar essa cadeia de caracteres chamando SysFreeString.

compression

Um valor MBN_COMPRESSION que especifica se a compactação é usada no link de dados para cabeçalho e dados.

Esse membro é aplicável somente a dispositivos GSM.

authType

Um valor MBN_AUTH_PROTOCOL que indica o tipo de compactação usado para ativação PDP (Protocolo de Dados de Pacote).

Esse membro é aplicável somente a dispositivos GSM. Para dispositivos CDMA, ele é definido como MBN_AUTH_PROTOCOL_NONE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	mbnapi.h