Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| en:docs:fapi:dosgetenv [2021/08/31 04:03] – prokushev | en:docs:fapi:dosgetenv [2021/12/05 09:57] (current) – prokushev | ||
|---|---|---|---|
| Line 5: | Line 5: | ||
| This call returns the address of the process environment string for the current process. | This call returns the address of the process environment string for the current process. | ||
| - | ==Syntax== | + | ===== Syntax |
| <code c> | <code c> | ||
| Line 11: | Line 11: | ||
| </ | </ | ||
| - | ==Parameters== | + | ===== Parameters |
| - | * EnvSegment (PSEL) - output : Address of the selector for the environment segment. | + | * EnvSegment ([[PSEL]]) - output : Address of the selector for the environment segment. |
| - | * CmdOffset (PUSHORT) - output : Address of the offset to the command line within the environment segment. | + | * CmdOffset ([[PUSHORT]]) - output : Address of the offset to the command line within the environment segment. |
| - | ==Return Code== | + | ===== Return Code ===== |
| - | * rc (USHORT) - return: | + | rc ([[USHORT]]) - return: |
| * 0 NO_ERROR | * 0 NO_ERROR | ||
| * 12 ERROR_INVALID_ACCESS | * 12 ERROR_INVALID_ACCESS | ||
| - | ==Remarks== | + | ===== Remarks |
| DosGetEnv can be used by dynamic link library routines that need to determine the environment for the current process. | DosGetEnv can be used by dynamic link library routines that need to determine the environment for the current process. | ||
| Line 29: | Line 29: | ||
| When a process issues [[DosExecPgm]] to start another process, the program that receives control is returned a pointer to the environment segment. | When a process issues [[DosExecPgm]] to start another process, the program that receives control is returned a pointer to the environment segment. | ||
| - | ==Bindings== | + | ===== Bindings |
| - | ===C Binding=== | + | ==== C Binding ==== |
| <code c> | <code c> | ||
| #define INCL_DOSMISC | #define INCL_DOSMISC | ||
| Line 40: | Line 41: | ||
| USHORT | USHORT | ||
| - | </ | + | </ |
| - | ===MASM=== | + | ==== MASM ==== |
| <code asm> | <code asm> | ||
| EXTRN DosGetEnv: | EXTRN DosGetEnv: | ||
| Line 54: | Line 55: | ||
| </ | </ | ||
| - | ==Example Code== | + | ==== Example Code ==== |
| The following example shows how one may obtain information for program initialization. The program locates the environment segment and prints the name of the command from the command line. It then obtains the OS/2 version number and prints it. | The following example shows how one may obtain information for program initialization. The program locates the environment segment and prints the name of the command from the command line. It then obtains the OS/2 version number and prints it. | ||
| Line 99: | Line 100: | ||
| - | ====== Note ====== | + | ===== Note ===== |
| Text based on [[http:// | Text based on [[http:// | ||