DosScanEnv

This call scans (searches) an environment segment for an environment variable.

DosScanEnv

(EnvVarName, ResultPointer)

EnvVarName (PSZ) - input

Address of the name of the environment variable. Do not include a trailing " = ", since this is not part of the name.
ResultPointer (PSZ FAR *) - output
Address where the system returns the pointer to the environment string. ResultPointer points to the first character of the string that is the value of the environment variable and can be passed directly into DosSearchPath.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 203
  ERROR_ENVVAR_NOT_FOUND
  Remarks

  Assume that the process' environment contains:

          "DPATH=c:\sysdir;c:\libdir"
                 |
                 │
                 │
                 └---- ResultPointer points here after the
                          following call to DosScanEnv:
  
          DosScanEnv("DPATH", &ResultPointer);
  

  As noted above, ResultPointer points to the first character of the value of the environment variable.

  ---

  [Back: DosRmDir]
  [Next: DosSearchPath]