---
name: "DoEnvironmentSubstA"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/DoEnvironmentSubstA"
---

# DoEnvironmentSubstA(3w)

## NAME

**DoEnvironmentSubstA** (SHELL32.@)

## SYNOPSIS

DWORD DoEnvironmentSubstA\
  (\
   LPSTR *pszString*,\
   UINT  *cchString*\
  )

## DESCRIPTION

Replace %KEYWORD% in the str with the value of variable **KEYWORD** from environment. If it is not found the %KEYWORD% is left intact. If the buffer is too small, str is not modified.

## PARAMS

*pszString* **\[In\]**  **' '** terminated string with %keyword%.

**\[Out\]**  **' '** terminated string with %keyword% substituted.

*cchString* **\[In\]**  size of str.

## RETURNS

*cchString* length in the HIWORD; **TRUE** in **LOWORD** if subst was successful and **FALSE** in other case

## IMPLEMENTATION

Declared in **"shellapi.h"**.

Implemented in **"dlls/shell32/shellord.c"**.

Debug channel **"shell"**.