_chdrive

Článek
06/09/2015

Změní aktuální pracovní jednotku.

Důležité
Toto API nelze použít v aplikacích, které jsou spuštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

int _chdrive( 
   int drive 
);

Parametry

drive
Celé číslo v rozmezí 1 až 26, které určuje aktuální pracovní jednotku (1 = A, 2 = B a tak dále).

Vrácená hodnota

Nula (0), pokud aktuální pracovní jednotka byla změněna úspěšně, jinak -1.

Poznámky

Pokud drive není v rozmezí 1 až 26, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud smí provádění pokračovat, funkce _chdrive vrátí -1, errno se nastaví na EACCES a _doserrno se nastaví na ERROR_INVALID_DRIVE.

Funkce _chdrive není bezpečná pro vlákno, protože je závislá na funkci SetCurrentDirectory, která sama o sobě není bezpečné pro vlákno.Chcete-li použít _chdrive bezpečně ve vícevláknové aplikaci, je nutné zadat vlastní synchronizaci vláken.Další informace naleznete v knihovně MSDN po vyhledání SetCurrentDirectory.

Funkce _chdrive změní pouze aktuální pracovní jednotku; _chdir změní aktuální pracovní adresář.