DosQueryExtLIBPATH
From EDM2
Returns the current path to be searched before or after the system LIBPATH when locating DLLs.
Syntax
ulrc = DosQueryExtLIBPATH(pszExtLIBPATH, flags);
Parameters
- pszExtLIBPATH (PSZ) - output
- Extended LIBPATH string.
- If the buffer pointed to by this parameter is not large enough to hold the extended LIBPATH or an extended LIBPATH is not currently defined, this parameter returns a pointer to a NULL string.
- flags (ULONG) - output
- Flag indicating when the new path is searched.
- Possible values are described in the following list:
- BEGIN_LIBPATH The new path is searched before the LIBPATH.
- END_LIBPATH The new path is searched after the LIBPATH.
Return Code
- ulrc (APIRET) - returns
- DosQueryExtLIBPATH returns one of the following values:
- 0 NO_ERROR
- 87 ERROR_INVALID_PARAMETER
- 122 ERROR_INSUFFICIENT_BUFER
Example Code
This example updates the paths to be searched before and after the system LIBPATH, when locating a DLL.
#define INCL_DOSMISC #define INCL_DOSERRORS #include <os2.h> #include <stdio.h> int main(VOID) { UCHAR uchBeginLIBPATH[512] = ""; /* Begin LIBPATH value returned */ UCHAR uchEndLIBPATH[512] = ""; /* End LIBPATH value returned */ APIRET rc = NO_ERROR; /* Return code */ rc = DosSetExtLIBPATH("C:\\TOOL_X\\VERS_20\\DLL", BEGIN_LIBPATH); /* Add to beginning LIBPATH */ if (rc != NO_ERROR) { printf("DosSetExtLIBPATH error: return code = %u\n", rc); return 1; } rc = DosSetExtLIBPATH("C:\\TOOL_X\\VERS_10\\DLL", END_LIBPATH); /* Add to ending LIBPATH */ if (rc != NO_ERROR) { printf("DosSetExtLIBPATH error: return code = %u\n", rc); return 1; } rc = DosQueryExtLIBPATH(uchBeginLIBPATH, BEGIN_LIBPATH); /* Query the BeginLIBPATH */ if (rc != NO_ERROR) { printf("DosQueryExtLIBPATH error: return code = %u\n", rc); return 1; } rc = DosQueryExtLIBPATH(uchEndLIBPATH, END_LIBPATH); /* Query the EndLIBPATH */ if (rc != NO_ERROR) { printf("DosQueryExtLIBPATH error: return code = %u\n", rc); return 1; } printf(" BeginLIBPATH = %s\n", uchBeginLIBPATH); printf(" EndLIBPATH = %s\n", uchEndLIBPATH); return NO_ERROR; }