Freigeben über


CHandle Class

Diese Klasse stellt Methoden zum Erstellen und Verwenden eines Handleobjekts bereit.

class CHandle

Mitglieder

Öffentliche Konstruktoren

Name

Description

CHandle::CHandle

Der -Konstruktor.

CHandle::~CHandle

Der Destruktor.

Öffentliche Methoden

Name

Description

CHandle::Attach

Rufen Sie diese Methode auf, um das Objekt CHandle zu einem vorhandenen Handle anzufügen.

CHandle::Close

Rufen Sie diese Methode auf, um ein CHandle-Objekt zu schließen.

CHandle::Detach

Rufen Sie diese Methode auf, um ein Handle von einem CHandle-Objekt zu trennen.

Öffentliche Operatoren

Name

Description

CHandle::operator HANDLE

Gibt den Wert des gespeicherten Handles zurück.

CHandle::operator =

Zuweisungsoperator

Öffentliche Datenmember

Name

Description

CHandle::m_h

Die Membervariable, die das Handle speichert.

Hinweise

Ein CHandle-Objekt kann verwendet werden, wenn ein Handle erforderlich ist: der Hauptunterschied liegt darin, dass das Objekt CHandle automatisch gelöscht wird.

Hinweis

Manche API-Funktionen verwenden NULL als leeres oder ungültiges Handle, während andere INVALID_HANDLE_VALUE verwenden.Verwendung CHandle nur MACHT ungültig und wird INVALID_HANDLE_VALUE als echtes Handle behandeln.Wenn Sie eine API aufrufen, das INVALID_HANDLE_VALUE zurückgeben kann, sollten Sie für diesen Wert überprüfen, bevor Sie CHandle::Attach aufrufen oder das CHandle-Konstruktor übergeben, und führen stattdessen NULL.

Anforderungen

Header: atlbase.h

Siehe auch

Weitere Ressourcen

ATL Class Overview