screen_set_session_property_pv()
Graphics and Screen4.0 (8.x)Screen Graphics Subsystem Developer's GuideAPIProgrammingUtilities
Set the value of the specified session property of type void*
Synopsis:
#include <screen/screen.h>
int screen_set_session_property_pv(screen_session_t ssn,
int pname,
void **param)
Arguments:
- ssn
- The handle of the session whose property is being set.
- pname
- The name of the property whose value is being set. The properties that you can set are of type Screen property types.
- param
- A pointer to a buffer containing the new value(s). This buffer must be of type
void*
.
Library:
libscreenDescription:
Function Type: Delayed Execution
This function sets the value of a session property from a user-provided buffer. You can use this function to set the value of the following properties:
- SCREEN_PROPERTY_ALTERNATE
- SCREEN_PROPERTY_BRUSH
- SCREEN_PROPERTY_DISPLAY (only session doesn't have a window)
- SCREEN_PROPERTY_USER_HANDLE
- SCREEN_PROPERTY_WINDOW
Returns:
0
if successful, or -1
if an error occurred (errno
is set; refer to errno.h
for more details).
Page updated: