_getdcwd, _wgetdcwd

아티클
04/10/2013

지정한 드라이브의 현재 작업 디렉터리의 전체 경로 가져옵니다.

중요
이 API는 Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

char *_getdcwd( 
   int drive,
   char *buffer,
   int maxlen 
);
wchar_t *_wgetdcwd( 
   int drive,
   wchar_t *buffer,
   int maxlen 
);

매개 변수

drive
드라이브를 지정 하는 음수가 아닌 정수 (0 = 1 기본 드라이브 2 A = B = 등).

지정된 된 드라이브를 사용할 수 없는 경우 또는 드라이브의 종류 (예를 들어, 이동식, 고정, CD-ROM, RAM, 디스크 또는 네트워크 드라이브) 확인할 수 없습니다 설명 하는 잘못 된 매개 변수 처리기를 매개 변수 유효성 검사을 호출 됩니다.
buffer
저장소 위치는 경로 또는 NULL.

경우 NULL 지정한이 함수는 버퍼를 이상 할당 maxlen 크기를 사용 하 여 malloc, 및 반환 값을 _getdcwd 할당 된 버퍼에 대 한 포인터입니다.호출 하 여 버퍼 해제 될 수 있습니다 free 포인터를 전달 합니다.
maxlen
경로의 최대 길이를 지정 합니다. 0이 아닌 양의 정수: char 에 대 한 _getdcwd 및 wchar_t 에 대 한 _wgetdcwd.

경우 maxlen 에서 설명 하는 잘못 된 매개 변수 처리기 0 보다 크지 않은 매개 변수 유효성 검사에서 호출 됩니다.

반환 값

지정된 된 드라이브의 현재 작업 디렉터리의 전체 경로 나타내는 문자열에 대 한 포인터 또는 NULL, 오류를 나타냅니다.

경우 buffer 로 지정 된 NULL 할당할 메모리가 부족 하 고 maxlen 오류가 발생 하는 문자 및 errno 로 설정 된 ENOMEM.Null 종결 문자를 포함 하는 경로 길이 초과 하는 경우 maxlen, 오류가 발생 하 고 errno 로 설정 된 ERANGE.이러한 오류 코드에 대 한 자세한 내용은 errno, _doserrno, _sys_errlist, _sys_nerr.

설명

_getdcwd 함수는 지정한 드라이브의 현재 작업 디렉터리의 전체 경로 가져옵니다 및 저장 위치에서 buffer.현재 작업 디렉터리 루트에 설정 되어 있으면 문자열 백슬래시 (\)를 종료 합니다.현재 작업 디렉터리 이외의 디렉터리 루트에 설정 되어 있으면 디렉터리의 이름 및 않는 백슬래시 문자열을 종료 합니다.

_wgetdcwd와이드 문자 버전인 _getdcwd, 그리고 buffer 매개 변수와 반환 값 와이드 문자 문자열입니다.그렇지 않으면 _wgetdcwd 및 _getdcwd 동일 하 게 동작 합니다.

그 경우에이 함수는 스레드로부터 안전 하지 GetFullPathName, 자체는 스레드로부터 안전 하지 않은 것입니다.그러나이 함수는 모두 다중 스레드 응용 프로그램을 호출 하는 경우 스레드 안전성에 문제가 있습니다 및 GetFullPathName.이동에 대 한 자세한 내용은 MSDN Library 한 다음 검색 GetFullPathName.

이 함수 버전은 _nolock 접미사 동작 동일 하 게 하려면이 함수는 스레드로부터 안전 하지 않습니다 및 방해를 다른 스레드에서 보호 되지 않는 제외 하 고.자세한 내용은 _getdcwd_nolock, _wgetdcwd_nolock을 참조하십시오.

때 _DEBUG 및 _CRTDBG_MAP_ALLOC 정의 되 고 호출 _getdcwd 및 _wgetdcwd 호출 하 여 대체 _getdcwd_dbg 및 _wgetdcwd_dbg 메모리 할당을 디버깅할 수 있도록 합니다.자세한 내용은_getdcwd_dbg, _wgetdcwd_dbg를 참조하십시오.

일반 텍스트 루틴 매핑