CW2AEX-Klasse

Artikel
06/09/2015

Diese Klasse wird durch Makros für Zeichenfolgenkonvertierung CT2AEX, CW2TEX, CW2CTEX und CT2CAEX und Typedef CW2A 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 CW2AEX

Parameter

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

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Operatoren

Name	Description
CW2AEX::operator LPSTR	Konvertierungsoperator.

Öffentliche Datenmember

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

Hinweise

Es sei denn, zusätzlich, sind Funktionen erforderlich, verwendet CT2AEX, CW2TEX, CW2CTEX, CT2CAEX oder CW2A 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: