estrutura WWAN_UICC_APP_INFO (wwan.h)

Artigo
08/08/2023

A estrutura WWAN_UICC_APP_INFO descreve informações sobre um aplicativo UICC.

Sintaxe

typedef struct _WWAN_UICC_APP_INFO {
  WWAN_UICC_APP_TYPE AppType;
  ULONG              AppIdSize;
  BYTE               AppId[WWAN_UICC_APP_ID_MAX_LEN];
  ULONG              AppNameLength;
  BYTE               AppName[WWAN_UICC_APP_NAME_MAX_LEN];
  ULONG              NumPins;
  BYTE               PinRef[WWAN_UICC_PINREF_MAX];
} WWAN_UICC_APP_INFO, *PWWAN_UICC_APP_INFO;

Membros

AppType

Um valor WWAN_UICC_APP_TYPE que especifica o tipo do aplicativo UICC.

AppIdSize

O tamanho da ID do aplicativo em bytes, conforme definido na Seção 8.3 da especificação técnica ETSI TS 102 221. Esse campo é definido como zero (0) para os tipos de aplicativo WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM ou WwanUiccAppTypeMfRUIM .

AppId[WWAN_UICC_APP_ID_MAX_LEN]

A ID do aplicativo. Somente os primeiros bytes AppIdSize são significativos. Se a ID do aplicativo for maior que WWAN_UICC_APP_ID_MAX_LEN bytes, AppIdSize especificará o comprimento real, mas apenas os primeiros bytes WWAN_UICC_APP_ID_MAX_LEN estarão nesse campo. Esse campo só é válido quando AppType não é WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM ou WwanUiccAppTypeMfRUIM.

AppNameLength

O comprimento, em caracteres, do nome do aplicativo.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

Uma cadeia de caracteres UTF-8 que especifica o nome do aplicativo. O comprimento desse campo é especificado por AppNameLength. Se o comprimento for maior ou igual a WWAN_UICC_APP_NAME_MAX_LEN bytes, esse campo conterá o primeiro WWAN_UICC_APP_NAME_MAX_LEN - 1 bytes do nome. A cadeia de caracteres é sempre terminada em nulo.

NumPins

O número de referências de PIN do aplicativo. Em outras palavras, o número de elementos de PinRef que são válidos. Os aplicativos em um R-UIM virtual não têm referências de PIN.

PinRef[WWAN_UICC_PINREF_MAX]

Uma matriz de bytes que especifica as referências de PIN do aplicativo para este aplicativo (chaves para PIN1 e possivelmente UPIN), conforme definido na Seção 9.4.2 da especificação técnica ETSI TS 102 221. No caso de uma cartão de verificação única ou de um driver MBB e/ou modem que não dá suporte a chaves de aplicativo diferentes para aplicativos diferentes, esse campo deve ser 0x01.