_chdrive

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

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

int _chdrive(
   int drive
);

Parametry

drive
Celé číslo od 1 do 26 určující aktuální pracovní jednotku (1=A, 2=B atd.).

Vrácená hodnota

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

Poznámky

Pokud drive není v rozsahu od 1 do 26, vyvolá se obslužná rutina neplatného parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, _chdrive vrátí funkce hodnotu -1, errno je nastavena na EACCEShodnotu a _doserrno je nastavena na ERROR_INVALID_DRIVEhodnotu .

Funkce _chdrive není bezpečná pro přístup z více vláken, protože závisí na SetCurrentDirectory funkci, která není bezpečná pro přístup z více vláken. Pokud chcete bezpečně používat _chdrive ve vícevláknové aplikaci, musíte zadat vlastní synchronizaci vláken. Další informace najdete na webu SetCurrentDirectory.

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

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina	Požadovaný hlavičkový soubor
_chdrive	<direct.h>

Další informace naleznete v tématu Kompatibilita.

Příklad

Podívejte se na příklad pro _getdrive.

Viz také

Ovládací prvek adresář
_chdir, _wchdir
_fullpath, _wfullpath
_getcwd, _wgetcwd
_getdrive
_mkdir, _wmkdir
_rmdir, _wrmdir
system, _wsystem