[in / out] Descriptorul obiectului deschis.
Dacă funcția reușește, valoarea valorii returnate este nenulă.
Dacă funcția nu reușește cu o eroare, valoarea valorii returnate este zero. Pentru a obține informații suplimentare despre erori, sunați la GetLastError.
Deoarece valorile pseudo-descriptorilor sunt permise ca valide de la funcția GetCurrentHandle. ele (sau - (minus) 1) pot fi specificate ca valoare hObject.
Această funcție va ridica o excepție dacă valoarea de descriptor care nu este validă (sau 0) sau valoarea pseudo-descriptorului este specificată ca valoare hObject. iar aplicația rulează în mediul de depanare. Aceasta include închiderea mânerului de două ori și utilizarea funcției CloseHandle pentru mânerul returnat de funcția FindFirstFile.
Fiți atenți! faptul că această funcție nu va genera o excepție în cazul în care valoarea mânerului care nu este permisă, sau valoarea pseudo-mâner este dat, iar aplicația nu se execută în mediul de depanare.
Funcția CloseHandle închide descriptorii următoarelor obiecte:
- Atributul accesului
- Dispozitiv de comunicație
- Consola de intrare de date
- Tamponul consolei de ecran
- eveniment
- fișier
- Fișierul care trebuie afișat în memorie
- sarcină
- Căsuța poștală din kernelul sistemului
- mutex
- Conductă numită
- canal
- Procesul
- semafor
- priză
- curent
- Cronometru de așteptare
Funcția CloseHandle anulează descriptorul de obiect specificat, reduce numărul total de descriptori de obiecte și efectuează o verificare a prezenței obiectului. După ce ultimul descriptor al obiectului este închis, obiectul este scos din sistem.
Închiderea descriptorului firului nu încheie firul asociat. Pentru a șterge un obiect de fir, trebuie să terminați fluxul, apoi închideți toate descriptorii firului.
Utilizați funcția CloseHandle. pentru a închide descriptorii returnați prin apelarea funcției CreateFile. Utilizați funcția FindClose. pentru a închide descriptorii returnați prin apelarea funcției FindFirstFile.
Articole similare
Trimiteți-le prietenilor: