ExpandEnvironmentStringsA 함수(processenv.h)

환경 변수 문자열을 확장하고 현재 사용자에 대해 정의된 값으로 바꿉니다.

특정 사용자 또는 시스템에 대한 환경 블록을 지정하려면 ExpandEnvironmentStringsForUser 함수를 사용합니다.

통사론

DWORD ExpandEnvironmentStringsA(
  [in]            LPCSTR lpSrc,
  [out, optional] LPSTR  lpDst,
  [in]            DWORD  nSize
);

매개 변수

[in] lpSrc

하나 이상의 환경 변수 문자열을 포함하는 버퍼입니다. %variableName%. 이러한 각 참조에 대해 %variableName% 부분은 해당 환경 변수의 현재 값으로 대체됩니다.

환경 변수 이름을 조회할 때는 대/소문자를 무시합니다. 이름을 찾을 수 없으면 %variableName% 부분은 표시되지 않은 상태로 유지됩니다.

이 함수는 Cmd.exe 지원하는 모든 기능을 지원하지는 않습니다. 예를 들어 %variableName지원되지 않습니다.str1=str2% 또는 %variableName:~오프셋,길이%.

[out, optional] lpDst

lpSrc 버퍼에서 환경 변수 문자열을 확장한 결과를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 lpSrc 버퍼와 동일할 수 없습니다.

[in] nSize

lpDst 매개 변수가 가리키는 버퍼에 저장할 수 있는 최대 문자 수입니다. ANSI 문자열을 사용하는 경우 버퍼 크기는 문자열 길이와 종료 null 문자 및 1이어야 합니다. 유니코드 문자열을 사용하는 경우 버퍼 크기는 문자열 길이와 종료 null 문자여야 합니다.

반환 값

함수가 성공하면 반환 값은 종료 null 문자를 포함하여 대상 버퍼에 저장된 TCHAR의 수입니다. 대상 버퍼가 너무 작아 확장된 문자열을 보유할 수 없을 경우 반환 값은 필요한 버퍼 크기(문자)입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

Windows Server 2003 및 Windows XP:lpSrc 및 lpDst 버퍼의 크기는 32K로 제한됩니다.

정규화된 경로의 폴더 이름을 연결된 환경 변수 문자열로 바꾸려면 PathUnExpandEnvStrings 함수를 사용합니다.

프로세스에 대한 환경 변수 목록을 검색하려면 GetEnvironmentStrings 함수를 사용합니다.

예제

예를 들어 시스템 정보 가져오기참조하세요.

요구 사항

참고 항목

환경 변수

시스템 정보 함수