CA2WEX-Klasse

Artikel
06/09/2015

Diese Klasse wird durch Makros für Zeichenfolgenkonvertierung CA2TEX, CA2CTEX, CT2WEX und CT2CWEX und Typedef CA2W verwendet.

Wichtig

Diese Klasse und ihre Member können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.

template< 
int t_nBufferLength= 128 
> 
class CA2WEX

Parameter

t_nBufferLength
Die Größe des Puffers verwendet im Übersetzungsprozess. Die Standardlänge ist 128 Bytes.

Mitglieder

Öffentliche Konstruktoren

Name	Description
CA2WEX::CA2WEX	Der -Konstruktor.
CA2WEX::~CA2WEX	Der Destruktor.

Öffentliche Operatoren

Name	Description
CA2WEX::operator LPWSTR	Konvertierungsoperator.

Öffentliche Datenmember

Name	Description
CA2WEX::m_psz	Der Datenmember, der die Quellzeichenfolge speichert.
CA2WEX::m_szBuffer	Der statische Puffer, verwendet die konvertierte Zeichenfolge speichern.

Hinweise

Es sei denn, zusätzlich, sind Funktionen erforderlich, verwendet CA2TEX, CA2CTEX, CT2WEX, CT2CWEX oder CA2W im Code.

Diese Klasse enthält einen statischen Puffer fester Größe, der verwendet wird, um das Ergebnis der Konvertierung zu speichern. Wenn das Ergebnis zu groß ist, in den statischen Puffer passt, belegt die Klasse mithilfe malloc Speicher und gibt den Arbeitsspeicher frei, wenn das Objekt den Gültigkeitsbereich verlässt. Dadurch wird sichergestellt, dass, anders als die Textkonvertierungsmakros, die in früheren Versionen von ATL verfügbar sind, diese Klasse sicher, in Schleifen zu verwenden ist und nicht der Stapel überschritten.

Wenn die Klasse versucht, auf dem Heap Speicher reserviert und fehlschlägt, ruft sie AtlThrow mit einem Argument von E_OUTOFMEMORY auf.

Standardmäßig verwenden die ATL-Konvertierungsklassen und Makros die aktuelle ANSI-Codepage des Threads für die Konvertierung. Wenn Sie dieses Verhalten für eine bestimmte Konvertierung überschreiben möchten, geben Sie die Codepage als zweiten Parameter an den Konstruktor für die Klasse.

Die folgenden Makros sind auf dieser Klasse: