RILADDRESS-Struktur (ntddrilapitypes.h)

Warnung Die Mobilfunk-COM-API ist in Windows 10 veraltet. Dieser Inhalt wird bereitgestellt, um die Wartung von OEM- und Mobilfunkanbietern zu unterstützen, die Windows Phone 8.1-Anwendungen erstellt wurden.

 

Diese Struktur stellt eine Telefonnummer dar.

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)

Weitere Informationen

Mobilfunk-COM-Strukturen