__segmentlimit

Microsoft Specific

Generates the lsl (Load Segment Limit) instruction.

unsigned long __segmentlimit( 
   unsigned long a 
);

Parameters

• [in] a
  A constant that specifies the segment selector.

Return Value

The segment limit of the segment selector specified by a, provided that the selector is valid and visible at the current permission level.

Requirements

Intrinsic	Architecture
__segmentlimit	x86, x64

Header file <intrin.h>

Remarks

If the segment limit cannot be retrieved, this instruction fails. On failure, this instruction clears the ZF flag and the return value is undefined.

This routine is only available as an intrinsic.

Example

#include <stdio.h>

#ifdef _M_IX86
typedef unsigned int READETYPE;
#else
typedef unsigned __int64 READETYPE;
#endif

#define EFLAGS_ZF      0x00000040
#define KGDT_R3_DATA    0x0020
#define RPL_MASK        0x3

extern "C"
{
unsigned long __segmentlimit (unsigned long);
READETYPE __readeflags();
}

#pragma intrinsic(__readeflags)
#pragma intrinsic(__segmentlimit)

int main(void)
{
   const unsigned long initsl = 0xbaadbabe;
   READETYPE eflags = 0;
   unsigned long sl = initsl;

   printf("Before: segment limit =0x%x eflags =0x%x\n", sl, eflags);
   sl = __segmentlimit(KGDT_R3_DATA + RPL_MASK);

   eflags = __readeflags();

   printf("After: segment limit =0x%x eflags =0x%x eflags.zf = %s\n", sl, eflags, (eflags & EFLAGS_ZF) ? "set" : "clear");

   // If ZF is set, the call to lsl succeeded; if ZF is clear, the call failed.
   printf("%s\n", eflags & EFLAGS_ZF ? "Success!": "Fail!");

   // You can verify the value of sl to make sure that the instruction wrote to it
   printf("sl was %s\n", (sl == initsl) ? "unchanged" : "changed");

   return 0;
}

Before: segment limit =0xbaadbabe eflags =0x0 After: segment limit =0xffffffff eflags =0x256 eflags.zf = set Success! sl was changed

See Also

Reference

Compiler Intrinsics

Change History

Date	History	Reason
September 2008	Clarified the results of this instruction.	Content bug fix.