_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 EACCESwartość i _doserrno jest ustawiona na ERROR_INVALID_DRIVEwartość .

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. W celu uzyskania więcej informacji, zobacz następujący temat: 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