Sack Library Documentation
ContentsIndexReferenceHome
Functions
Functions
 
Name 
Description 
 
CheckClassRoot reads for a path of names, but does not create it if it does not exist. 
 
Registers a structure as creatable in shared memory by name. So a single name of the structure can be used to retrieve a pointer to one created.
 
 
Registers a structure as creatable in shared memory by name. So a single name of the structure can be used to retrieve a pointer to one created.
 
 
Releases an interface. When interfaces are registered, they register with a OnGetInterface and an OnDropInterface callback so that it may do additional work to cleanup from giving you a copy of the interface. 
 
Outputs through syslog a tree dump of all names registered. 
 
Dumps through syslog all names registered from the specified root point. (instead of dumping the whole tree) 
 
Returns a PCLASSROOT of a specified path. The path may be either a PCLASSROOT or a text string indicating the path. the Ex versions allow passing a base PCLASSROOT path and an additional subpath to get. GetClassRoot will always create the path if it did not exist before, and will always result with a root.
 
 
Returns a PCLASSROOT of a specified path. The path may be either a PCLASSROOT or a text string indicating the path. the Ex versions allow passing a base PCLASSROOT path and an additional subpath to get. GetClassRoot will always create the path if it did not exist before, and will always result with a root.
 
 
Returns a PCLASSROOT of a specified path. The path may be either a PCLASSROOT or a text string indicating the path. the Ex versions allow passing a base PCLASSROOT path and an additional subpath to get. GetClassRoot will always create the path if it did not exist before, and will always result with a root.
 
 
Returns a PCLASSROOT of a specified path. The path may be either a PCLASSROOT or a text string indicating the path. the Ex versions allow passing a base PCLASSROOT path and an additional subpath to get. GetClassRoot will always create the path if it did not exist before, and will always result with a root.
 
 
When using GetFirstRegisteredName and GetNextRegisteredName to browse through names, this function is able to get the current PCLASSROOT of the current node, usually you end up with just the content of that registered name.

result with the current node ( useful for pulling registered subvalues like description, or file and line ) 
 
Get[First/Next]RegisteredName( WIDE("classname"), &data ); these operations are not threadsafe and multiple thread accesses will cause mis-stepping

These functions as passed the address of a POINTER. this POINTER is for the use of the browse routines and should is meaningless to he calling application. 
 
Get[First/Next]RegisteredName( WIDE("classname"), &data ); these operations are not threadsafe and multiple thread accesses will cause mis-stepping

These functions as passed the address of a POINTER. this POINTER is for the use of the browse routines and should is meaningless to he calling application. 
 
Get[First/Next]RegisteredName( WIDE("classname"), &data ); these operations are not threadsafe and multiple thread accesses will cause mis-stepping

These functions as passed the address of a POINTER. this POINTER is for the use of the browse routines and should is meaningless to he calling application. 
 
Returns the pointer to a registered interface. This is typically a structure that contains pointer to functions. Takes a text string to an interface. Interfaces are registered at a known location in the registry tree. 
 
Steps to the next registered name being browsed. Is passed only the pointer to data. See GetFirstRegisteredName for usage. 
 
 
 
 
 
 
 
Gets a function that has been registered. 
 
Gets a function that has been registered. 
 
Gets a function that has been registered. 
 
Gets a function that has been registered. 
 
Gets a function that has been registered. 
 
Gets a function that has been registered. 
 
This is like GetRegisteredValue, but takes the address of the type to return into instead of having to cast the final result.

if bIntValue, result should be passed as an (&int) 
 
 
 
 
 
 
 
 
 
This is function sack::app::registry::LoadTree. 
 
while doing a scan for registered procedures, allow applications to check for branches PROCREG_PROC( int, NameHasBranches )( POINTER *data ); 
 
while doing a scan for registered procedures, allow applications to ignore aliases... 
 
root, return, public, args, address 
 
attempts to use dynamic linking functions to resolve passed global name if that fails, then a type is registered for this global, and an instance created, so that that instance may be reloaded again, otherwise the data in the main application is used... actually we should deprecate the dynamic loading part, and just register the type.

SimpleRegisterAndCreateGlobal Simply registers the type as a global variable type. Allows creation of the global space later. 
 
Init routine is called, otherwise a 0 filled space is returned. Init routine is passed the pointer to the global and the size of the global block the global data block is zero initialized. 
 
  • Branches on the tree may be aliased together to form a single branch
*
RegisterClassAlias( WIDE("psi/control/button"), WIDE("psi/control/3") ); then the same set of values can be referenced both ways with really only a single modified value. parameters to RegisterClassAliasEx are the original name, and the new alias name for the origianl branch 
 
  • Branches on the tree may be aliased together to form a single branch
*
RegisterClassAlias( WIDE("psi/control/button"), WIDE("psi/control/3") ); then the same set of values can be referenced both ways with really only a single modified value. parameters to RegisterClassAliasEx are the original name, and the new alias name for the origianl branch 
 
This is function sack::app::registry::RegisterDataType. 
 
This is function sack::app::registry::RegisterDataTypeEx. 
 
define RegisterFunctionExx( r,nc,p,rt,proc,ar ) RegisterFunctionExx( r,nc,p,rt,proc,ar,TARGETNAME,NULL DBG_SRC
 
define RegisterFunctionExx( r,nc,p,rt,proc,ar ) RegisterFunctionExx( r,nc,p,rt,proc,ar,TARGETNAME,NULL DBG_SRC
 
This is function sack::app::registry::RegisterInterface. 
 
This is function sack::app::registry::RegisterIntValue. 
 
This is function sack::app::registry::RegisterIntValueEx. 
 
This is function sack::app::registry::RegisterIntValueEx. 
 
RegisterProcedureExx( 
 
This is function sack::app::registry::RegisterValue. 
 
This is function sack::app::registry::RegisterValueEx. 
 
This is function sack::app::registry::RegisterValueExx. 
 
unregister a function, should be smart and do full return type and parameters..... but for now this only references name, this indicates that this has not been properly(fully) extended, and should be layered in such a way as to allow this function work in it's minimal form. 
 
a tree dump will result with dictionary names that may translate automatically. This has been exported as a courtesy for StrDup.
  • this routine MAY result with a translated string.
  • this routine MAY result with the same pointer.
  • this routine MAY need to be improved if MANY more strdups are replaced
  • Add a binary tree search index when large.
  • Add a transaltion tree index at the same time.
 
 
no space stripping, saves literal text 
 
This is function sack::app::registry::SaveTree. 
 
This is function sack::app::registry::SetInterfaceConfigFile. 
Created with a commercial version of Doc-O-Matic. In order to make this message disappear you need to register this software. If you have problems registering this software please contact us at support@toolsfactory.com.
Copyright (c) 2000+. All rights reserved.