`_chdrive`

Artikel
10/12/2023

Mengubah drive kerja saat ini.

Penting

API ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

int _chdrive(
   int drive
);

Parameter

drive
Bilangan bulat dari 1 hingga 26 yang menentukan drive kerja saat ini (1=A, 2=B, dan sebagainya).

Nilai hasil

Nol (0) jika drive kerja saat ini berhasil diubah; jika tidak, -1.

Keterangan

Jika drive tidak dalam rentang dari 1 hingga 26, handler parameter tidak valid dipanggil seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, _chdrive fungsi mengembalikan -1, errno diatur ke EACCES, dan _doserrno diatur ke ERROR_INVALID_DRIVE.

Fungsi _chdrive ini tidak aman untuk utas karena tergantung pada SetCurrentDirectory fungsi, yang tidak aman untuk thread. Untuk menggunakan _chdrive dengan aman dalam aplikasi multi-utas, Anda harus menyediakan sinkronisasi utas Anda sendiri. Untuk informasi selengkapnya, lihat SetCurrentDirectory .

Fungsi _chdrive hanya mengubah drive kerja saat ini; _chdir mengubah direktori kerja saat ini.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan
`_chdrive`	<direct.h>

Untuk informasi selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk _getdrive.