_getdcwd_nolock, _wgetdcwd_nolock

Article
06/05/2017

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _getdcwd_nolock, _wgetdcwd_nolock.

Gets the full path of the current working directory on the specified drive.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

Syntax

char *_getdcwd_nolock(   
   int drive,  
   char *buffer,  
   int maxlen   
);  
wchar_t *_wgetdcwd_nolock(   
   int drive,  
   wchar_t *buffer,  
   int maxlen   
);

Parameters

drive
Disk drive.

buffer
Storage location for the path.

maxlen
Maximum length of path in characters: char for _getdcwd and wchar_t for _wgetdcwd.

Return Value

See _getdcwd, _wgetdcwd.

Remarks

_getdcwd_nolock and _wgetdcwd_nolock are identical to _getdcwd and _wgetdcwd, respectively, except that they are not protected from interference by other threads. They might be faster because they do not incur the overhead of locking out other threads. Use these functions only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.

Generic-Text Routine Mappings

Tchar.h routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
`_tgetdcwd_nolock`	`_getdcwd_nolock`	`_getdcwd_nolock`	`_wgetdcwd_nolock`

Requirements

Routine	Required header
`_getdcwd_nolock`	<direct.h>
`_wgetdcwd_nolock`	<direct.h> or <wchar.h>

For more compatibility information, see Compatibility.

.NET Framework Equivalent

System::Environment::CurrentDirectory