WWAN_UICC_APP_INFO 구조체(wwan.h)

WWAN_UICC_APP_INFO 구조는 UICC 애플리케이션에 대한 정보를 설명합니다.

구문

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;

멤버

AppType

UICC 애플리케이션의 형식을 지정하는 WWAN_UICC_APP_TYPE 값입니다.

AppIdSize

ETSI TS 102 221 기술 사양의 섹션 8.3에 정의된 대로 애플리케이션 ID의 크기(바이트)입니다. 이 필드는 WwanUiccAppTypeMf, WwanUiccAppTypeMfSIM 또는 WwanUiccAppTypeMfRUIM 앱 형식에 대해 0으로 설정됩니다.

AppId[WWAN_UICC_APP_ID_MAX_LEN]

애플리케이션 ID입니다. 첫 번째 AppIdSize 바이트만 의미가 있습니다. 애플리케이션 ID가 WWAN_UICC_APP_ID_MAX_LEN 바이트보다 긴 경우 AppIdSize 는 실제 길이를 지정하지만 첫 번째 WWAN_UICC_APP_ID_MAX_LEN 바이트만 이 필드에 있습니다. 이 필드는 AppTypeWwanUiccAppTypeMf, WwanUiccAppTypeMfSIM 또는 WwanUiccAppTypeMfRUIM이 아닌 경우에만 유효합니다.

AppNameLength

애플리케이션 이름의 길이(문자)입니다.

AppName[WWAN_UICC_APP_NAME_MAX_LEN]

애플리케이션의 이름을 지정하는 UTF-8 문자열입니다. 이 필드의 길이는 AppNameLength로 지정됩니다. 길이가 WWAN_UICC_APP_NAME_MAX_LEN 바이트보다 크거나 같은 경우 이 필드에는 이름의 첫 번째 WWAN_UICC_APP_NAME_MAX_LEN 1 바이트가 포함됩니다. 문자열은 항상 null로 종료됩니다.

NumPins

애플리케이션 PIN 참조 수입니다. 즉, 유효한 PinRef 의 요소 수입니다. 가상 R-UIM의 애플리케이션에는 PIN 참조가 없습니다.

PinRef[WWAN_UICC_PINREF_MAX]

ETSI TS 102 221 기술 사양의 섹션 9.4.2에 정의된 대로 이 애플리케이션에 대한 애플리케이션 PIN 참조(PIN1 및 UPIN의 키)를 지정하는 바이트 배열입니다. 단일 확인 카드 또는 다른 애플리케이션에 대해 다른 애플리케이션 키를 지원하지 않는 MBB 드라이버 및/또는 모뎀의 경우 이 필드는 0x01 합니다.

설명

이 구조체는 WWAN_UICC_APP_LIST 구조체에서 사용됩니다.

다음 상수는 이 구조체의 Wwan.h 헤더에 정의됩니다.

#define WWAN_UICC_APP_ID_MAX_LEN 32
#define WWAN_UICC_APP_NAME_MAX_LEN 256
#define WWAN_UICC_PINREF_MAX 8

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10, 버전 1903
머리글 wwan.h

추가 정보

MB UICC 애플리케이션 및 파일 시스템 액세스

OID_WWAN_UICC_APP_LIST

WWAN_UICC_APP_LIST

WWAN_UICC_APP_TYPE