ITextServices::TxGetText-Methode (textserv.h)

Artikel
08/26/2023

Gibt den gesamten Unicode-Nur-Text im -Steuerelement als BSTR zurück.

Syntax

HRESULT TxGetText(
  BSTR *pbstrText
);

Parameter

pbstrText

Typ: BSTR *

Der Unicode-Nur-Text.

Rückgabewert

Typ: HRESULT

Wenn der Text erfolgreich im Ausgabeargument zurückgegeben wird, wird der Rückgabewert S_OK.

Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden HRESULT-Codes . Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültiger BSTR-Zeiger übergeben.
E_OUTOFMEMORY	Der Speicher für die Kopie des Texts konnte nicht zugewiesen werden.

Hinweise

Der Host (Aufrufer) übernimmt den Besitz des zurückgegebenen BSTR.

Andere Möglichkeiten zum Abrufen von Nur-Text-Daten sind die Verwendung WM_GETTEXT oder der TOM-Methode (Text Object Model) GetText.

Wenn kein Text im Steuerelement vorhanden ist, wird der BSTR zugeordnet, und 0x000D wird darin zurückgegeben.

Der zurückgegebene Text ist nicht notwendigerweise null-endend.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
DLL	Msftedit.dll