_getdcwd_dbg, _wgetdcwd_dbg
Отладочные версии функций _getdcwd, _wgetdcwd (доступны только во время отладки)
char *_getdcwd_dbg( int drive, char *buffer, int maxlen, int blockType, const char *filename, int linenumber ); wchar_t *_wgetdcwd_dbg( int drive, wchar_t *buffer, int maxlen, int blockType, const char *filename, int linenumber );
Параметры
drive
Имя диска.buffer
Место хранения пути.maxlen
Максимальная длина пути в символах: char для _getdcwd_dbgи wchar_tдля _wgetdcwd_dbg.blockType
Запрошенный тип блока памяти: _CLIENT_BLOCKили _NORMAL_BLOCK.filename
Указатель на имя исходного файла, который запросил операцию выделения, или NULL.linenumber
Номер строки в исходном файле, в которой была запрошена операция выделения, или NULL.
Возвращаемое значение
Возвращает указатель на buffer. Возвращаемое значение NULL указывает на ошибку, а для errno задается значение ENOMEM, указывающее на недостаток памяти для выделения maxlen байт (если аргумент NULL задан как buffer), или значение ERANGE, указывающее, что длина пути превышает maxlen. Для получения дополнительной информации см. errno, _doserrno, _sys_errlist, and _sys_nerr.
Заметки
Функции _getdcwd_dbg и _wgetdcwd_dbg идентичны _getdcwd и _wgetdcwd за исключением того, что если определен флаг _DEBUG, эти функции используют отладочную версию функций malloc и _malloc_dbg для выделения памяти, если NULL передается как параметр buffer. Для получения дополнительной информации см. _malloc_dbg.
Как правило, явно вызывать эти функции не требуется. Вместо этого можно определить флаг _CRTDBG_MAP_ALLOC. Если определен флаг _CRTDBG_MAP_ALLOC, вызовы функций _getdcwd и _wgetdcwd повторно сопоставляются с _getdcwd_dbg и _wgetdcwd_dbg соответственно, а для параметра blockType задается тип _NORMAL_BLOCK. Таким образом, не требуется явно вызывать эти функции, если только нет необходимости пометить блоки кучи как _CLIENT_BLOCK. Для получения дополнительной информации см. Типы блоков в отладочной куче.
Универсальное текстовое сопоставление функций
Процедура Tchar.h |
_UNICODE и _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_tgetdcwd_dbg |
_getdcwd_dbg |
_getdcwd_dbg |
_wgetdcwd_dbg |
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
_getdcwd_dbg |
<crtdbg.h> |
_wgetdcwd_dbg |
<crtdbg.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.