IMbnSms::SmsSendCdma-Methode (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Sendet eine Nachricht im CDMA-Format.
Syntax
HRESULT SmsSendCdma(
[in] LPCWSTR address,
[in] MBN_SMS_CDMA_ENCODING encoding,
[in] MBN_SMS_CDMA_LANG language,
[in] ULONG sizeInCharacters,
[in] SAFEARRAY *message,
[out] ULONG *requestID
);
Parameter
[in] address
Eine NULL-Zeichenfolge, die die Telefonnummer des Empfängers enthält. Die maximale Größe der Zeichenfolge beträgt 15 Ziffern.
[in] encoding
Ein MBN_SMS_CDMA_ENCODING Wert, der die Datencodierung angibt.
[in] language
Ein MBN_SMS_CDMA_LANG Wert, der die Sprache angibt.
[in] sizeInCharacters
Die Anzahl der codierten Zeichen in der Nachricht. Dies kann sich von der Größe des Nachrichtenarrays unterscheiden.
[in] message
Ein Bytearray, das die codierte CDMA-Nachricht enthält.
Die maximale Größe dieses Arrays ist die CdmaShortMsgSize-Eigenschaft von IMbnSmsConfiguration, diese darf jedoch nicht größer als MBN_CDMA_SHORT_MSG_SIZE_MAX (160) sein.
[out] requestID
Ein Zeiger auf eine Vom Mobilen Breitbanddienst ausgestellte Anforderungs-ID, um diese Anforderung zu identifizieren.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt. |
|
Die Schnittstelle ist ungültig, höchstwahrscheinlich, weil das Gerät aus dem System entfernt wurde. |
|
Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt. |
|
Das Gerät unterstützt das Senden von SMS-Nachrichten im angeforderten Format nicht. Beispielsweise, wenn diese Funktion für ein GSM-Gerät aufgerufen wird. |
Hinweise
Diese Methode kann verwendet werden, um eine SMS-Nachricht für ein CDMA-Gerät zu senden. Dies ist jedoch nur der Fall, wenn das CDMA-Gerät das Senden von SMS unterstützt. Eine aufrufende Anwendung kann erfahren, ob das Gerät dieses Format unterstützt, indem sie die GetInterfaceCapability-Methode von IMbnInterface aufruft. Anschließend kann im smsCaps-Element von MBN_INTERFACE_CAPS nach MBN_SMS_CAPS_TEXT_SEND gesucht werden.
Der Address-Parameter kann in einem der folgenden Formate vorliegen.
- "+ <Internationale Ländervorwahl><SMS Service Center-Nummer>\0"
- "<SMS Service Center Number>\0"
Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Wenn die Methode ohne Fehler zurückgibt, ruft der Mobile Broadband-Dienst die OnSmsSendComplete-Methode der IMbnSmsEvents-Schnittstelle auf .
Anforderungen
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Nicht unterstützt |
Zielplattform | Windows |
Kopfzeile | mbnapi.h |