CloseHandle
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função fecha um aberto objeto identificador. Um remoto versão API (RAPI) dessa função existe chamado CeCloseHandle (RAPI).
Syntax
BOOL CloseHandle(
HANDLE hObject
);
Parameters
- hObject
[no] Identificador para um aberto objeto.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
For All Platforms:
Essa função fecha alças para a seguinte objetos:
- Dispositivo de comunicação
- Banco de dados
- Contexto enumeração do banco de dados
- Evento
- Arquivo
- Arquivo-objeto mapeamento
- Mutex
- Processo
- Soquete
- Segmento
Essa função invalida o identificador especificado objeto, decrementa número de identificadores do o objeto e executa verificações de retenção objeto. Após o último identificador para um objeto estiver fechado, o objeto é removido do sistema. Objetos persistentes, como bancos de dados e arquivos, permanecem no armazenamento, mas devem ser reabertos seja acessado novamente.
Fechar um identificador segmento não finalizar o associado segmento. Para remover um objeto segmento, você deverá finalizar o segmento e em seguida, fechar todos os identificadores de segmento.
Use esta função para fechar alças retornadas por chamadas para a função CreateFile. Use a função FindClose para fechar alças retornadas por chamadas para a função FindFirstFile.
Quando um aplicativo execução em modo usuário chama essa função, o kernel chama funções internas que limpar qualquer associado recursos, como MyFileSystem_PreCloseHandle e MyFileSystem_CloseHandle.
For Windows Embedded CE:
No passado, quando um usuário-chamar modo fechado um identificador, uma falha de preclose interno e fechar funções poderia causar essa função falha. Esse comportamento foi alterado. Com Windows Embedded CE 6.0 e posterior, essa função é bem-sucedida em qualquer válido identificador, regardless of resultados que podem ser retornados pelo preclose interno e fechar funções.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
File I/O Functions
CreateFile
CreateFileForMapping
CreateFileMapping
CeFindFirstDatabaseEx (CEDB)
DeleteFile
FindClose
FindFirstFile