_chdrive
Zmienia bieżący dysk roboczy.
Ważne
Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.
Składnia
int _chdrive(
int drive
);
Parametry
drive
Liczba całkowita z zakresu od 1 do 26, która określa bieżący dysk roboczy (1=A, 2=B itd.).
Wartość zwracana
Zero (0), jeśli bieżący dysk roboczy został pomyślnie zmieniony; w przeciwnym razie, -1.
Uwagi
Jeśli drive
nie znajduje się w zakresie od 1 do 26, procedura obsługi nieprawidłowych parametrów jest wywoływana zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, _chdrive
funkcja zwraca wartość -1, errno
jest ustawiona na EACCES
wartość i _doserrno
jest ustawiona na ERROR_INVALID_DRIVE
wartość .
Funkcja _chdrive
nie jest bezpieczna wątkowo, ponieważ zależy od SetCurrentDirectory
funkcji, która sama nie jest bezpieczna wątkowo. Aby bezpiecznie używać _chdrive
w aplikacji wielowątkowa, należy zapewnić własną synchronizację wątków. Aby uzyskać więcej informacji, zobacz SetCurrentDirectory
.
Funkcja _chdrive
zmienia tylko bieżący dysk roboczy; _chdir
zmienia bieżący katalog roboczy.
Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.
Wymagania
Procedura | Wymagany nagłówek |
---|---|
_chdrive |
<direct.h> |
Aby uzyskać więcej informacji, zobacz Zgodność.
Przykład
Zobacz przykład dla elementu _getdrive
.
Zobacz też
Kontrolka katalogu
_chdir
, _wchdir
_fullpath
, _wfullpath
_getcwd
, _wgetcwd
_getdrive
_mkdir
, _wmkdir
_rmdir
, _wrmdir
system
, _wsystem