Ussd​Message Ussd​Message Ussd​Message Class

Definition

Represents a USSD message that is used for sending messages to and receiving messages from the network.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : sealed class UssdMessage : IUssdMessagepublic sealed class UssdMessage : IUssdMessagePublic NotInheritable Class UssdMessage Implements IUssdMessage
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Constructors

UssdMessage(String) UssdMessage(String) UssdMessage(String)

Creates a new instance of a UssdMessage and encodes the supplied string into the message payload.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : UssdMessage(PlatForm::String messageText)public UssdMessage(String messageText)Public Sub New(messageText As String)
Parameters
messageText
PlatForm::String String String

The payload for the UssdMessage.

Attributes

Remarks

The default UssdMessage constructor assigns the default DataCodingScheme value and encodes the string supplied to the constructor into the message payload.

Properties

DataCodingScheme DataCodingScheme DataCodingScheme

Gets or sets the encoding scheme of the payload of this UssdMessage.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : byte DataCodingScheme { get; set; }public byte DataCodingScheme { get; set; }Public ReadWrite Property DataCodingScheme As byte
Value
byte byte byte

The encoding scheme of the payload of this UssdMessage.

Attributes

Remarks

The data coding scheme is part of the USSD protocol. It is defined in 3GPP TS 23.038 chapter 5, CBS Data Coding Scheme

.

When a message is encoded in the default coding scheme, you can access the payload as text using the PayloadAsText property.

PayloadAsText PayloadAsText PayloadAsText

Gets or sets the payload of this UssdMessage as text.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : PlatForm::String PayloadAsText { get; set; }public string PayloadAsText { get; set; }Public ReadWrite Property PayloadAsText As string
Value
PlatForm::String string string

The payload of this UssdMessage as text.

Attributes

Remarks

The PayloadAsText property can be used with the default DataCodingScheme value, which supports only ASCII characters. The maximum length of a message is using the default data-coding scheme is 182 characters.

Methods

GetPayload() GetPayload() GetPayload()

Gets the raw payload of this UssdMessage.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : byte[] GetPayload()public byte[] GetPayload()Public Function GetPayload() As byte[]
Returns
byte[] byte[] byte[]

The raw payload of this UssdMessage.

Attributes

Remarks

The DataCodingScheme property identifies how the payload is encoded.

The maximum size of the raw payload is 160 bytes.

SetPayload(Byte[]) SetPayload(Byte[]) SetPayload(Byte[])

Sets the raw payload of this UssdMessage.

Note

This functionality is only available to mobile operator apps and Windows Store app given privileged access by mobile network operators.

For permission to use this API, please reach out to Network Operators API Permissions.

For technical help with this API, please reach out to Network Operators API Help

public : void SetPayload(Byte[] value)public void SetPayload(Byte[] value)Public Function SetPayload(value As Byte[]) As void
Parameters
value
Byte[] Byte[] Byte[]

The raw payload of this UssdMessage.

Attributes

Remarks

When you set the raw payload for a UssdMessage, you must first set the DataCodingScheme property to the encoding scheme for the message. If you do not set the DataCodingScheme property, the default coding scheme is used.

If you use the default coding scheme, you can access the payload as text using the PayloadAsText property.

The maximum size of the raw payload is 160 bytes.