Siemens SIMATIC PCS 7 Programming And Operating Manual page 92

Appendix
7.3 SFC API functions
BOOL SFCSaveWorkspace(LPCSTR pWsName);
Saves all open SFC windows for a specific user under the workspace (desktop layout)
"pWsName_user.SSM".
Parameter:
pWsName(in): Name of the desktop layout
Example: SFCSaveWorkspace("TestLayout1");
BOOL SFCRestoreWorkspace(LPCSTR pWsName);
Restores all the SFC windows saved using SFCSaveWorkSpace under the workspace
"pWsName_user.SSM".
Parameter:
pWsName(in): Name of the desktop layout
Example: SFCRestoreWorkspace("TestLayout1");
BOOL SFCDeleteWorkspace(LPCSTR pWsName);
Deletes the specified workspace from the hard disk.
Parameter:
pWsName(in): Name of the desktop layout
Example: SFCDeleteWorkspace("TestLayout1");
BOOL SFCCloseAllWindows();
Closes all open SFC windows.
Example: SFCCloseAllWindows();
BOOL SFCGetStepName(LPCSTR pChartName, LONG stepnumber, LPTSTR pStepName,
LONG length);
(Function is only used with V5 projects) Provides the step name for the step number of a chart or
instance.
Parameter:
pChartName(in): SFC chart name/instance name
stepnumber(in): Step number
pStepName(out): Step Name
length(in): Maximum length of the step name
BOOL SFCGetStepNameV6(LPCSTR pChartName, LONG lSequenceNumber, LONG
stepnumber, LPTSTR pStepName, LONG length);
Provides the step name for the sequencer number and step number of a chart or instance.
Parameter:
pChartName(in): SFC chart name/instance name
lSequenceNumber(in): Sequencer number
stepnumber(in): Step number
pStepName(out): Step Name
length(in): Maximum length of the step name
BOOL SFCGetSequenceName(LPCSTR pChartName, LONG lSequenceNumber, LONG
pSequenceName, LONG length);
Determines the sequencer name based on the sequencer number.
Parameter:
pChartName(in): SFC chart name/instance name
lSequenceNumber(in): Sequencer number
pSequenceName(out): Sequencer name
length(in): Maximum length of the sequencer name
92
Programming and Operating Manual, 05/2017, A5E41356392-AA
SFC Visualization (V9.0)