RILADDRESS-Struktur (ntddrilapitypes.h)
Syntax
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Angehörige
cbSize
Die Größe der Struktur in Byte.
dwParams
Eine bitweise Kombination aus RILADDRESSPARAMMASK Enumerationswerte, die angibt, welche Elemente der Struktur gültige Daten enthalten. Ein Element der Struktur ist gültig, wenn das entsprechende Bit-Flag festgelegt ist.
dwType
Der Adresstyp. Mögliche Werte werden in der folgenden Tabelle angezeigt.
| Wert | Bedeutung |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Unbekannter Typ |
| RIL_ADDRTYPE_INTERNATIONAL | Internationale Nummer |
| RIL_ADDRTYPE_NATIONAL | Nationale/regionale Nummer |
| RIL_ADDRTYPE_NETWKSPECIFIC | Netzwerkspezifische Nummer |
| RIL_ADDRTYPE_SUBSCRIBER | Abonnentennummer (protokollspezifisch) |
| RIL_ADDRTYPE_ALPHANUM | Alphanumerische Adresse |
| RIL_ADDRTYPE_ABBREV | Abgekürzte Zahl |
| RIL_ADDRTYPE_IP | IP-Adresse |
| RIL_ADDRTYPE_EMAIL | Internet-E-Mail-Adresse (RFC 822) |
dwNumPlan
Das Nummerierungsschema der Adresse. Mögliche Werte werden in der folgenden Tabelle angezeigt.
| Wert | Bedeutung |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Unbekannter Nummerierungsplan |
| RIL_NUMPLAN_TELEPHONE | ISDN/Telefonnummernplan (E.164/E.163) |
| RIL_NUMPLAN_DATA | Datennummerierungsplan (X.121) |
| RIL_NUMPLAN_TELEX | Telex-Nummerierungsplan |
| RIL_NUMPLAN_NATIONAL | Nationale/regionale Nummerierungsplan |
| RIL_NUMPLAN_PRIVATE | Plan für private Nummerierung |
| RIL_NUMPLAN_ERMES | ERMES Nummerierungsplan (ETSI DE/PS 3 01-3) |
wszAddress[256]
Ein Array von Adresszeichen. Die Mindestlänge dieses Arrays beträgt 3. Wenn dwType- auf RIL_ADDRTYPE_INTERNATIONALfestgelegt ist, wird das Pluszeichen (+) nicht wszAddress-vorangestellt. Es liegt an dem Client oder Modem, das Symbol anzufügen.
Bemerkungen
Wenn ein RILADDRESS- eine Telefonnummer auf einer UICC-Karte darstellt, sind die Inhalte wszAddress auf Werte beschränkt, die auf der Karte dargestellt werden können (wie durch 3GPP TS 31.102 Tabelle 4.4 definiert). In der UICC-Datei wird eine Telefonnummer durch eine Zeichenfolge mit 4-Bit-Nibbles auf der rechten Seite mit 0xF dargestellt. Die definierte Zuordnung wird in der folgenden Tabelle angezeigt.
| Nibble in UICC EF | WCHAR in wszAddress | Bedeutung |
|---|---|---|
| 0x0 | L'0' | Ziffer 0 |
| 0x1 | L'1' | Ziffer 1 |
| 0x2 | L'2' | Ziffer 2 |
| 0x3 | L'3' | Ziffer 3 |
| 0x4 | L'4' | Ziffer 4 |
| 0x5 | L'5' | Ziffer 5 |
| 0x6 | L'6' | Ziffer 6 |
| 0x7 | L'7' | Ziffer 7 |
| 0x8 | L'8' | Ziffer 8 |
| 0x9 | L'9' | Ziffer 9 |
| 0xA | L'*' | Sternchen |
| 0xB | L'#' | Pfundzeichen |
| 0xC | L'p' oder L'P' | DTMF-Steuerzifferntrennzeichen (siehe 3GPP TS 22.101) |
| 0xD | L'?' | "Wild"-Wert (siehe 3GPP TS 22.101) |
| 0xE | RFU – nicht zu verwenden | |
| 0xF | Abstand für nicht verwendete Nibbles auf der UICC-Karte – nicht zu verwenden |
Im Fall des Trennzeichens für Steuerziffern kann entweder Groß- oder Kleinbuchstaben "P" übergeben werden; die Ausgabe ist immer Kleinbuchstaben. Der RFU-Wert 0xE sollte nie auf der Karte angezeigt werden, aber wenn er als L'e gemeldet wird. Es ist ein Fehler, L'e' als Eingabe zu übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |