HandleT - класс
Представляет дескриптор объекта.
Синтаксис
template <typename HandleTraits>
class HandleT;
Параметры
HandleTraits
Экземпляр структуры HandleTraits , определяющий общие характеристики дескриптора.
Участники
Общедоступные определения типов
| Имя | Описание |
|---|---|
Traits |
Синоним для HandleTraits. |
Открытые конструкторы
| Имя | Описание |
|---|---|
| HandleT::HandleT | Инициализирует новый экземпляр класса HandleT. |
| HandleT::~HandleT | Деинициализирует экземпляр HandleT класса. |
Открытые методы
| Имя | Описание |
|---|---|
| HandleT::Attach | Связывает указанный дескриптор с текущим HandleT объектом. |
| HandleT::Close | Закрывает текущий HandleT объект. |
| HandleT::D etach | Отсоединяет текущий HandleT объект от базового дескриптора. |
| HandleT::Get | Возвращает значение базового дескриптора. |
| HandleT::IsValid | Указывает, представляет ли текущий HandleT объект дескриптор. |
Защищенные методы
| Имя | Описание |
|---|---|
| HandleT::InternalClose | Закрывает текущий HandleT объект. |
Открытые операторы
| Имя | Описание |
|---|---|
| HandleT::operator= | Перемещает значение указанного HandleT объекта в текущий HandleT объект. |
Защищенные члены данных
| Имя | Описание |
|---|---|
| HandleT::handle_ | Содержит дескриптор, представленный HandleT объектом. |
Иерархия наследования
HandleT
Требования
Заголовок: corewrappers.h
Пространство имен: Microsoft::WRL::Оболочки
HandleT::~HandleT
Деинициализирует экземпляр HandleT класса.
~HandleT();
HandleT::Attach
Связывает указанный дескриптор с текущим HandleT объектом.
void Attach(
typename HandleTraits::Type h
);
Параметры
ч
Дескриптор.
HandleT::Close
Закрывает текущий HandleT объект.
void Close();
Замечания
Дескриптор, который лежит в основе текущего HandleT , закрыт, и HandleT для этого задано недопустимое состояние.
Если дескриптор не закрывается правильно, возникает исключение в вызывающем потоке.
HandleT::D etach
Отсоединяет текущий HandleT объект от базового дескриптора.
typename HandleTraits::Type Detach();
Возвращаемое значение
Базовый дескриптор.
Замечания
По завершении этой операции текущий HandleT параметр имеет недопустимое состояние.
HandleT::Get
Возвращает значение базового дескриптора.
typename HandleTraits::Type Get() const;
Возвращаемое значение
Дескриптор.
HandleT::handle_
Содержит дескриптор, представленный HandleT объектом.
typename HandleTraits::Type handle_;
HandleT::HandleT
Инициализирует новый экземпляр класса HandleT.
explicit HandleT(
typename HandleTraits::Type h =
HandleTraits::GetInvalidValue()
);
HandleT(
_Inout_ HandleT&& h
);
Параметры
ч
Дескриптор.
Замечания
Первый конструктор инициализирует HandleT объект, который не является допустимым дескриптором объекта. Второй конструктор создает новый HandleT объект из параметра h.
HandleT::InternalClose
Закрывает текущий HandleT объект.
virtual bool InternalClose();
Возвращаемое значение
true Значение , если текущий HandleT объект успешно закрыт; в противном случае false.
Замечания
InternalClose() имеет значение protected.
HandleT::IsValid
Указывает, представляет ли текущий HandleT объект дескриптор.
bool IsValid() const;
Возвращаемое значение
trueЗначение , falseесли дескриптор HandleT представляет дескриптор; в противном случае .
HandleT::operator=
Перемещает значение указанного HandleT объекта в текущий HandleT объект.
HandleT& operator=(
_Inout_ HandleT&& h
);
Параметры
ч
Ссылка rvalue-на дескриптор.
Возвращаемое значение
Ссылка на текущий HandleT объект.
Замечания
Эта операция делает объект недействительным, заданным HandleT параметром h.