| #include <winmem32.h> |
| WORD Global16PointerFree(wSelector, dwAlias, wFlags) | |||||
| WORD wSelector; | /* selector of object, */ | ||||
| DWORD dwAlias; | /* pointer alias to free | */ | |||
| WORD wFlags; | /* reserved, must be zero | */ | |||
The Global16PointerFree function frees the 16:16 pointer alias previously created by a call to the Global16PointerAlloc function.
wSelector
Specifies the selector of the object for which the alias is to be freed. This must be the selector returned by a previous call to the Global32Alloc function.
dwAlias
Specifies the 16:16 pointer alias to be freed. This must be the alias (including the original offset) returned by a previous call to the Global16PointerAlloc function.
wFlags
Reserved; must be zero.
The return value is zero if the function is successful. Otherwise, it is an error value, which can be one of the following:
WM32_Insufficient_Mem
WM32_Insufficient_Sels
WM32_Invalid_Arg
WM32_Invalid_Flags
WM32_Invalid_Func
An application should free a 16:16 pointer alias as soon as it is no longer needed. Freeing the alias releases space in the descriptor table, a limited system resource.