_dupenv_s_dbg, _wdupenv_s_dbg
获取当前环境的值。 随 _malloc_dbg 的内存提供额外的调试信息 _dupenv_s, _wdupenv_s 的版本。
errno_t _dupenv_s_dbg(
char **buffer,
size_t *numberOfElements,
const char *varname,
int blockType,
const char *filename,
int linenumber
);
errno_t _wdupenv_s_dbg(
wchar_t **buffer,
size_t * numberOfElements,
const wchar_t *varname,
int blockType,
const char *filename,
int linenumber
);
参数
buffer
存储变量值的缓冲区。numberOfElements
buffer的大小。varname
环境变量名称。blockType
请求的内存块类型: _CLIENT_BLOCK 或 _NORMAL_BLOCK。filename
对源文件或 NULL名称的指针。linenumber
在源文件级别或 NULL的行号。
返回值
在成功的零,在失败时的错误代码。
这些功能验证方法的参数;如果 buffer 或 varname 是 NULL,无效参数调用处理程序 参数验证如中所述。 如果执行允许继续,对 EINVAL 的功能集 errno 和返回 EINVAL。
如果这些函数不能分配足够的内存,这些设置 buffer 到 NULL 和 numberOfElements 为 0,并返回 ENOMEM。
备注
_dupenv_s_dbg 和 _wdupenv_s_dbg 功能与 _dupenv_s 和 _wdupenv_s 相同,区别在于,那么,当 _DEBUG 定义时,这些功能使用 malloc, _malloc_dbg的调试版本,分配环境变量的值的内存。 有关 _malloc_dbg的信息调试功能,请参见 _malloc_dbg。
您不需要显式调用这些函数在许多情况下。 相反,您可以定义标志 _CRTDBG_MAP_ALLOC。 当 _CRTDBG_MAP_ALLOC 定义时,对 _dupenv_s,并 _wdupenv_s 已重新映射到 _dupenv_s_dbg 和 _wdupenv_s_dbg,分别,并 blockType 设置为 _NORMAL_BLOCK。 因此,,除非要标记堆块作为 _CLIENT_BLOCK,则无需显式调用这些函数。 有关的更多信息块类型,请参见 调试堆中的块类型。
一般文本例程映射
TCHAR.H 实例 |
未定义的 _UNICODE _MBCS |
定义的 _MBCS |
定义的 _UNICODE |
---|---|---|---|
_tdupenv_s_dbg |
_dupenv_s_dbg |
_dupenv_s_dbg |
_wdupenv_s_dbg |
要求
实例 |
必需的头 |
---|---|
_dupenv_s_dbg |
crtdbg.h |
_wdupenv_s_dbg |
crtdbg.h |
有关其他的兼容性信息,请参见中介绍的 兼容性 。
示例
// crt_dupenv_s_dbg.c
#include <stdlib.h>
#include <crtdbg.h>
int main( void )
{
char *pValue;
size_t len;
errno_t err = _dupenv_s_dbg( &pValue, &len, "pathext",
_NORMAL_BLOCK, __FILE__, __LINE__ );
if ( err ) return -1;
printf( "pathext = %s\n", pValue );
free( pValue );
err = _dupenv_s_dbg( &pValue, &len, "nonexistentvariable",
_NORMAL_BLOCK, __FILE__, __LINE__ );
if ( err ) return -1;
printf( "nonexistentvariable = %s\n", pValue );
free( pValue ); // It's OK to call free with NULL
}
示例输出
pathext = .COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.pl
nonexistentvariable = (null)
.NET Framework 等效项
系统:: 环境:: GetEnvironmentVariable