Jump to content

GpiOpenSegment: Difference between revisions

From EDM2
← Older editNewer edit →
No edit summary
Ak120 (talk | contribs)
35,819 edits
mNo edit summary
Line 4: Line 4:
==Parameters==
==Parameters==
;hps (HPS) - input:Presentation-space handle.
;hps (HPS) - input:Presentation-space handle.
;lSegment (LONG) - input
;lSegment (LONG) - input:Segment identifier.
:Segment identifier.
:Must be zero or a positive number.
:Must be zero or a positive number.


Line 16: Line 15:
Possible returns from WinGetLastError
Possible returns from WinGetLastError


;PMERR_INV_HPS (0x207F)
;PMERR_INV_HPS (0x207F):An invalid presentation-space handle was specified.  
        An invalid presentation-space handle was specified.  
;PMERR_PS_BUSY (0x20F4):An attempt was made to access the presentation space from more than one thread simultaneously.  
;PMERR_PS_BUSY (0x20F4)
;PMERR_INV_SEG_NAME (0x20C8):An invalid segment identifier was specified.  
        An attempt was made to access the presentation space from more than one thread simultaneously.  
;PMERR_INV_MICROPS_FUNCTION (0x20A1):An attempt was made to issue a function that is invalid in a micro presentation space.  
;PMERR_INV_SEG_NAME (0x20C8)
;PMERR_ALREADY_IN_SEG (0x2004):An attempt was made to open a new segment while an existing segment bracket was already open.  
        An invalid segment identifier was specified.  
;PMERR_PATH_INCOMPLETE (0x20EC):An attempt was made to open or close a segment either directly or during segment drawing, or to issue GpiAssociate while there is an open path bracket. ;PMERR_AREA_INCOMPLETE (0x2005):One of the following has occurred: o A segment has been opened, closed, or drawn.
;PMERR_INV_MICROPS_FUNCTION (0x20A1)
:* GpiAssociate was issued while an area bracket was open.
        An attempt was made to issue a function that is invalid in a micro presentation space.  
:* A drawn segment has opened an area bracket and ended without closing it.
;PMERR_ALREADY_IN_SEG (0x2004)
;PMERR_INV_MODE_FOR_REOPEN_SEG (0x20A5):An attempt was made to reopen an existing segment while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN.  
        An attempt was made to open a new segment while an existing segment bracket was already open.  
;PMERR_DYNAMIC_SEG_ZERO_INV (0x2029):An attempt was been made to open a dynamic segment with a segment identifier of zero.  
;PMERR_PATH_INCOMPLETE (0x20EC)
;PMERR_INV_MODE_FOR_OPEN_DYN (0x20A4):An attempt was made to open a segment with the ATTR_DYNAMIC segment set, while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN. ;PMERR_UNCHAINED_SEG_ZERO_INV (0x2108):An attempt was made to open segment with segment identifier zero and the ATTR_CHAINED segment attribute not specified.  
        An attempt was made to open or close a segment either directly or during segment drawing, or to issue GpiAssociate while there is an open path bracket. ;PMERR_AREA_INCOMPLETE (0x2005)
        One of the following has occurred: o A segment has been opened, closed, or drawn.
        o GpiAssociate was issued while an area bracket was open.
        o A drawn segment has opened an area
        bracket and ended without closing it.
;PMERR_INV_MODE_FOR_REOPEN_SEG (0x20A5)
        An attempt was made to reopen an existing segment while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN.  
;PMERR_DYNAMIC_SEG_ZERO_INV (0x2029)
        An attempt was been made to open a dynamic segment with a segment identifier of zero.  
;PMERR_INV_MODE_FOR_OPEN_DYN (0x20A4)
        An attempt was made to open a segment with the ATTR_DYNAMIC segment set, while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN. ;PMERR_UNCHAINED_SEG_ZERO_INV (0x2108)
        An attempt was made to open segment with segment identifier zero and the ATTR_CHAINED segment attribute not specified.  


[[Category:Gpi]]
[[Category:Gpi]]
[[Category:WorkToDo]]
[[Category:WorkToDo]]

Revision as of 11:15, 3 April 2025

Syntax

GpiOpenSegment(hps, lSegment)

Parameters

hps (HPS) - input
Presentation-space handle.
lSegment (LONG) - input
Segment identifier.
Must be zero or a positive number.

Returns

rc (BOOL) - returns
Success indicator.
  • TRUE - Successful completion
  • FALSE - Error occurred.

Errors

Possible returns from WinGetLastError

PMERR_INV_HPS (0x207F)
An invalid presentation-space handle was specified.
PMERR_PS_BUSY (0x20F4)
An attempt was made to access the presentation space from more than one thread simultaneously.
PMERR_INV_SEG_NAME (0x20C8)
An invalid segment identifier was specified.
PMERR_INV_MICROPS_FUNCTION (0x20A1)
An attempt was made to issue a function that is invalid in a micro presentation space.
PMERR_ALREADY_IN_SEG (0x2004)
An attempt was made to open a new segment while an existing segment bracket was already open.
PMERR_PATH_INCOMPLETE (0x20EC)
An attempt was made to open or close a segment either directly or during segment drawing, or to issue GpiAssociate while there is an open path bracket. ;PMERR_AREA_INCOMPLETE (0x2005):One of the following has occurred: o A segment has been opened, closed, or drawn.
  • GpiAssociate was issued while an area bracket was open.
  • A drawn segment has opened an area bracket and ended without closing it.
PMERR_INV_MODE_FOR_REOPEN_SEG (0x20A5)
An attempt was made to reopen an existing segment while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN.
PMERR_DYNAMIC_SEG_ZERO_INV (0x2029)
An attempt was been made to open a dynamic segment with a segment identifier of zero.
PMERR_INV_MODE_FOR_OPEN_DYN (0x20A4)
An attempt was made to open a segment with the ATTR_DYNAMIC segment set, while the drawing mode was set to DM_DRAW or DM_DRAWANDRETAIN. ;PMERR_UNCHAINED_SEG_ZERO_INV (0x2108):An attempt was made to open segment with segment identifier zero and the ATTR_CHAINED segment attribute not specified.
Retrieved from "https://www.edm2.com/index.php?title=GpiOpenSegment&oldid=84157"