Partilhar via

Classe CHandle

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe fornece métodos para criar e utilizar um objeto handle.

Sintaxe

class CHandle

Membros

Construtores Públicos

Nome Description
CAVALO::CAandle O construtor.
CHandle::~CHandle O destruidor.

Métodos Públicos

Nome Description
CHAandle::Anexar Chame este método para anexar o CHandle objeto a um handle existente.
CHAandle::Fechar Chama este método para fechar um CHandle objeto.
CHA: :D etach Chame este método para separar uma pega de um CHandle objeto.

Operadores Públicos

Nome Description
CHandle::HANDLE de operador Devolve o valor do handle armazenado.
CHandle::operator = Operador de atribuição.

Membros de Dados Públicos

Nome Description
CHandle::m_h A variável membro que armazena o handle.

Observações

Um CHandle objeto pode ser usado sempre que um handle for necessário: a principal diferença é que o CHandle objeto será automaticamente eliminado.

Observação

Algumas funções da API usam NULL como um handle vazio ou inválido, enquanto outras usam INVALID_HANDLE_VALUE. CHandle Usa apenas NULL e trata INVALID_HANDLE_VALUE como um handle real. Se chamar uma API que possa devolver INVALID_HANDLE_VALUE, deve verificar este valor antes de chamar CHandle::Attach ou passá-lo ao CHandle construtor, e passar NULL.

Requerimentos

Cabeçalho: atlbase.h

CHAandle::Anexar

Chame este método para anexar o CHandle objeto a um handle existente.

void Attach(HANDLE h) throw();

Parâmetros

h
CHandle Vai assumir a alça H.

Observações

Atribui o CHandle objeto ao handle h e depois chama h.Detach(). Em builds de depuração, um ATLASSERT será ativado se h for NULL. Não é feita outra verificação quanto à validade do nome.

CAVALO::CAandle

O construtor.

CHandle() throw();
CHandle(CHandle& h) throw();
explicit CHandle(HANDLE h) throw();

Parâmetros

h
Um handle existente ou CHandle.

Observações

Cria um novo CHandle objeto, opcionalmente usando um handle ou CHandle objeto existente.

CHandle::~CHandle

O destruidor.

~CHandle() throw();

Observações

Liberta o CHandle objeto chamando CHandle::Close.

CHAandle::Fechar

Chama este método para fechar um CHandle objeto.

void Close() throw();

Observações

Fecha uma maçaneta de objeto aberta. Se o handle for NULL, o que será o caso se Close já tiver sido chamado, um ATLASSERT será criado em builds de depuração.

CHA: :D etach

Chame este método para separar uma pega de um CHandle objeto.

HANDLE Detach() throw();

Valor de retorno

Devolve a pega a ser desligada.

Observações

Liberta a propriedade do cabo.

CHandle::m_h

A variável membro que armazena o handle.

HANDLE m_h;

CHandle::operator =

O operador de atribuição.

CHandle& operator=(CHandle& h) throw();

Parâmetros

h
CHandle Vai assumir a alça H.

Valor de retorno

Devolve uma referência ao novo CHandle objeto.

Observações

Se o CHandle objeto atualmente contiver um handle, este será fechado. O CHandle objeto que está a ser passado terá a referência do handle definida como NULL. Isto garante que dois CHandle objetos nunca conterão o mesmo handle ativo.

CHandle::HANDLE de operador

Devolve o valor do handle armazenado.

operator HANDLE() const throw();

Observações

Devolve o valor armazenado em CHandle::m_h.

Consulte também

Visão geral da classe

  • Last updated on