hdc (HDC) - input

Device context handle.

idPath (LONG) - input

Path ID.

When this is passed as 0, it indicates "no clipping". Otherwise, the new clip path is intersected with the existing clip path.

flOptions (ULONG) - input

Option flags.

The following flags determine the path mode:

SCP_ALTERNATE

(Default) Use alternate mode for intersection.
SCP_WINDING
Use winding mode for intersection.
The following flags determine whether the new path replaces or intersects the initial path:

SCP_AND

Intersect the two clip paths. If idPath is not 1, this flag is invalid and the handling routine must log an error.
SCP_RESET
(Default) Replace the initial clip path. If idPath is not 0, this flag is invalid and the handling routine must log an error.
SCP_EXCL
Path is exclusive of bottom and right border in device coordinate.
Other flags are reserved and must be 0.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreSelectClipPath.

fSuccess (BOOL) - returns

Return codes.

This function returns BOOLEAN (fSuccess).

TRUE

Successful
FALSE
Error
Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:

PMERR_BASE_ERROR PMERR_BITMAP_NOT_SELECTED
PMERR_COORDINATE_OVERFLOW
PMERR_DEV_FUNC_NOT_INSTALLED
PMERR_HDC_BUSY
PMERR_HRGN_BUSY
PMERR_INSUFFICIENT_MEMORY
PMERR_INV_CLIP_PATH_OPTIONS
PMERR_INV_COLOR_DATA
PMERR_INV_COLOR_INDEX
PMERR_INV_COORD_SPACE
PMERR_INV_COORDINATE
PMERR_INV_HDC
PMERR_INV_HRGN
PMERR_INV_IN_AREA
PMERR_INV_IN_PATH
PMERR_INV_LENGTH_OR_COUNT
PMERR_INV_PATH_ID
PMERR_INV_PICK_APERTURE_POSN
PMERR_INV_RECT
PMERR_INV_REGION_CONTROL
PMERR_PATH_LIMIT_EXCEEDED
PMERR_PATH_UNKNOWN
PMERR_REGION_IS_CLIP_REGION

Refer to the "Error Explanations" section in the Presentation Manager Programming Reference for further explanation.