RILADDRESS-Struktur (ntddrilapitypes.h)
Syntax
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Member
cbSize
Die Größe dieser Struktur in Byte.
dwParams
Eine bitweise Kombination von RILADDRESSPARAMMASK-Enumerationswerten , die angibt, welche Member der Struktur gültige Daten enthalten. Ein Element der Struktur ist gültig, wenn das entsprechende Bitflag festgelegt ist.
dwType
Der Adresstyp. Mögliche Werte werden in der folgenden Tabelle angezeigt.
| Wert | Bedeutung |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Typ „unknown“ |
| 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 | Nationaler/regionaler Nummerierungsplan |
| RIL_NUMPLAN_PRIVATE | Privater Nummerierungsplan |
| RIL_NUMPLAN_ERMES | ERMES-Nummerierungsplan (ETSI DE/PS 3 01-3) |
wszAddress[256]
Ein Array von Adresszeichen. Die Mindestlänge dieses Arrays ist 3. Wenn dwType auf RIL_ADDRTYPE_INTERNATIONAL festgelegt ist, wird dem Pluszeichen (+) nicht wszAddress vorangestellt. Es liegt beim Client oder Modem, das Symbol anzufügen.
Hinweise
Wenn eine RILADDRESS eine Telefonnummer auf einer UICC-Karte darstellt, sind die Inhalte von wszAddress auf Werte beschränkt, die auf dem Karte dargestellt werden können (gemäß 3GPP TS 31.102 Tabelle 4.4). In der UICC-Datei wird eine Telefonnummer durch eine Zeichenfolge von 4-Bit-Knabbereien dargestellt, die auf der rechten Seite mit 0xF. Die definierte Zuordnung wird in der folgenden Tabelle dargestellt.
| Knabbern 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-Trennzeichen für Steuerziffern (siehe 3GPP TS 22.101) |
| 0xD | L'?' | Wert "Wild" (siehe 3GPP TS 22.101) |
| 0xE | RFU – nicht zu verwenden | |
| 0xF | Auffüllung für nicht verwendete Nibbles auf UICC-Karte – nicht zu verwenden |
Im Fall des Trennzeichens für Steuerziffern kann "P" in Groß- oder Kleinbuchstaben übergeben werden; die Ausgabe ist immer Kleinbuchstaben. Der RFU-Wert 0xE sollte niemals auf dem Karte angezeigt werden, wird aber in diesem Fall als L'e' gemeldet. Es ist ein Fehler, L'e' als Eingabe zu übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |