Sack Library Documentation
ContentsIndexReferenceHome
PreviousUpNext
sack::app::registry::GetFirstRegisteredNameEx Function
C++
IMPORT_METHOD CTEXTSTR CPROC GetFirstRegisteredNameEx(PCLASSROOT root, CTEXTSTR classname, PCLASSROOT * data);
IMPORT_METHOD CTEXTSTR CPROC GetFirstRegisteredName(PCLASSROOT classname, PCLASSROOT * data);
IMPORT_METHOD CTEXTSTR CPROC GetFirstRegisteredName(CTEXTSTR classname, PCLASSROOT * data);
Parameters 
Description 
PCLASSROOT root 
The root to search from 
CTEXTSTR classname 
A sub-path from the root to search from 
PCLASSROOT * data 
the address of a pointer that keeps track of information about the search. (opaque to user) 

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.

Usage:

CTEXTSTR result;
POINTER data = NULL;
for( result = GetFirstRegisteredName( "some/class/path", &data );
     result;
     result = GetNextRegisteredName( &data ) )
{
     // result is a string name of the current node.
     // can use that name and GetRegistered____ (function/int/value)
     if( NameHasBranches( &data ) ) // for consitancy in syntax
     {
         // consider recursing through tree, name becomes a valid classname for GetFirstRegisteredName()
     }
}
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.
What do you think about this topic? Send feedback!