Struktur RILADDRESS (ntddrilapitypes.h)

Peringatan API COM Seluler tidak digunakan lagi dalam Windows 10. Konten ini disediakan untuk mendukung pemeliharaan OEM dan operator seluler yang dibuat Windows Phone aplikasi 8.1.
 
Struktur ini menunjukkan nomor telepon.

Sintaks

struct RILADDRESS {
  DWORD cbSize;
  DWORD dwParams;
  DWORD dwType;
  DWORD dwNumPlan;
  WCHAR wszAddress[MAXLENGTH_ADDRESS];
};

Anggota

cbSize

Ukuran struktur dalam byte.

dwParams

Kombinasi bit dari nilai enumerasi RILADDRESSPARAMMASK yang menunjukkan anggota struktur mana yang berisi data yang valid. Anggota struktur valid jika bendera bit yang sesuai diatur.

dwType

Jenis alamat. Kemungkinan nilai ditunjukkan dalam tabel berikut.

Nilai Makna
RIL_ADDRTYPE_UNKNOWN Jenis tidak diketahui
RIL_ADDRTYPE_INTERNATIONAL Nomor internasional
RIL_ADDRTYPE_NATIONAL Nomor nasional/regional
RIL_ADDRTYPE_NETWKSPECIFIC Nomor khusus jaringan
RIL_ADDRTYPE_SUBSCRIBER Nomor pelanggan (khusus protokol)
RIL_ADDRTYPE_ALPHANUM Alamat alfanumerik
RIL_ADDRTYPE_ABBREV Nomor yang disingkat
RIL_ADDRTYPE_IP Alamat IP
RIL_ADDRTYPE_EMAIL Alamat email internet (RFC 822)

dwNumPlan

Skema penomoran alamat. Kemungkinan nilai ditunjukkan dalam tabel berikut.

Nilai Makna
RIL_NUMPLAN_UNKNOWN Paket penomoran tidak diketahui
RIL_NUMPLAN_TELEPHONE Paket penomoran ISDN/telepon (E.164/E.163)
RIL_NUMPLAN_DATA Paket penomoran data (X.121)
RIL_NUMPLAN_TELEX Paket penomoran teleks
RIL_NUMPLAN_NATIONAL Rencana penomoran nasional/regional
RIL_NUMPLAN_PRIVATE Paket penomoran privat
RIL_NUMPLAN_ERMES Paket penomoran ERMES (ETSI DE/PS 3 01-3)

wszAddress[256]

Array karakter alamat. Panjang minimum array ini adalah 3. Ketika dwType diatur ke RIL_ADDRTYPE_INTERNATIONAL, tanda plus (+) tidak diawali dengan wszAddress. Terserah klien atau modem untuk melampirkan simbol .

Keterangan

Ketika RILADDRESS mewakili nomor telepon pada kartu UICC, isi wszAddress dibatasi untuk nilai yang dapat diwakili pada kartu (seperti yang ditentukan oleh tabel 3GPP TS 31.102 4.4). Dalam file UICC, nomor telepon diwakili oleh untai (karakter) 4-bit yang dilapisi di sebelah kanan dengan 0xF. Pemetaan yang ditentukan diperlihatkan dalam tabel berikut.

nibble di UICC EF WCHAR di wszAddress Makna
0x0 L'0' Digit 0
0x1 L'1' Digit 1
0x2 L'2' Digit 2
0x3 L'3' Digit 3
0x4 L'4' Digit 4
0x5 L'5' Digit 5
0x6 L'6' Digit 6
0x7 L'7' Digit 7
0x8 L'8' Digit 8
0x9 L'9' Digit 9
0xA L'*' Karakter tanda bintang
0xB L'#' Karakter pound
0xC L'p' atau L'P' Pemisah digit kontrol DTMF (lihat 3GPP TS 22.101)
0xD L'?' Nilai "Wild" (lihat 3GPP TS 22.101)
0xE RFU—tidak digunakan
0xF Padding untuk nibble yang tidak digunakan pada kartu UICC—tidak digunakan
 

Dalam kasus pemisah digit kontrol, baik huruf besar atau kecil 'P' dapat diteruskan; output selalu huruf kecil. Nilai RFU 0xE seharusnya tidak pernah muncul pada kartu, tetapi jika nilai tersebut dilaporkan sebagai L'e'. Ini adalah kesalahan untuk meneruskan L'e' sebagai input.

Persyaratan

Persyaratan Nilai
Header ntddrilapitypes.h (termasuk Rilapitypes.h, Ntddrilapitypes.h)

Lihat juga

Struktur COM Seluler