NAME

DtWsmGetWorkspacesOccupied − get the workspaces in which a window resides

SYNOPSIS

#include <Dt/Wsm.h>
Status DtWsmGetWorkspacesOccupied(Display ∗display,
Window window,
Atom ∗∗ppaWorkspaces,
int ∗pNumWs);

DESCRIPTION

The DtWsmGetWorkspacesOccupied() function works with the CDE workspace manager, dtwm(1), and returns the list of workspaces in which this window resides.  Each element of the list is the name of a workspace (converted to an X atom). 

The display argument is the X display.  The window argument is the window of interest.  The ∗ppaWorkspaces argument is the address of a pointer to receive the pointer to a list of workspace names (converted to X atoms).  The pNumWs argument is the address of an integer to receive the number of elements in the list of workspaces returned in ∗ppaWorkspaces. 

RETURN VALUE

Upon successful completion, the DtWsmGetWorkspacesOccupied() function returns Success and the workspace manager returns in ∗ppaWorkspaces a list of atoms identifying the occupied workspaces, and returns in pNumWs the number of occupied workspaces; otherwise, it returns a value not equal to Success. 

APPLICATION USAGE

If the DtWsmGetWorkspacesOccupied() function is not successful, failure may be due to a memory allocation error or failure to find the correct workspace information (that is, the CDE workspace manager, dtwm(1), is not running).  The application must use XtFree(3X) to free data returned in ∗ppaWorkspaces. 

SEE ALSO

DtWsm(5), XtFree(3X), dtwm(1). 

  —  19 Apr 1994