version 1.1.2.12, 2009/09/09 13:16:14
|
version 1.1.2.13, 2009/09/18 09:11:11
|
|
|
* Has to be copied by caller. | * Has to be copied by caller. |
* It is set to NULL if rc != SCMO_OK. | * It is set to NULL if rc != SCMO_OK. |
* @param pvalue Returns a pointer to the value of property. | * @param pvalue Returns a pointer to the value of property. |
* The value has to be copied by the caller ! |
* The value is strored in a SCMBUnion |
|
* and has to be copied by the caller ! |
* It returns NULL if rc != SCMO_OK. | * It returns NULL if rc != SCMO_OK. |
|
* |
* If the value is an array, the | * If the value is an array, the |
* value array is stored in continuous memory. | * value array is stored in continuous memory. |
* e.g. If the CIMType is CIMTYPE_UINT32: |
* e.g. (SCMBUnion*)value[0 to size-1] |
* value = (void*)Uint32[0 to size-1] |
* |
* If it is an array of CIMTYPE_STRING, an array |
* If the value is type of CIMTYPE_STRING, |
* of char* to the string values is returned. |
* the string is referenced by the structure |
* This array has to be freed by the caller ! |
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
|
* Only for strings the caller has to free pvalue ! |
* @param type Returns the CIMType of the property | * @param type Returns the CIMType of the property |
* It is invalid if rc == SCMO_INDEX_OUT_OF_BOUND. | * It is invalid if rc == SCMO_INDEX_OUT_OF_BOUND. |
* @param isArray Returns if the value is an array. | * @param isArray Returns if the value is an array. |
|
|
Uint32 pos, | Uint32 pos, |
const char** pname, | const char** pname, |
CIMType& type, | CIMType& type, |
const void** pvalue, |
const SCMBUnion** pvalue, |
Boolean& isArray, | Boolean& isArray, |
Uint32& size ) const; | Uint32& size ) const; |
| |
|
|
* Sub-pointers are NOT resolved! | * Sub-pointers are NOT resolved! |
* The value has to be copied by the caller ! | * The value has to be copied by the caller ! |
* It returns NULL if rc != SCMO_OK. | * It returns NULL if rc != SCMO_OK. |
* If the value is an array, the |
|
* value array is stored in continuous memory. |
|
* e.g. If the CIMType is CIMTYPE_UINT32: |
|
* value = (void*)Uint32[0 to size-1] |
|
* If it is an array of CIMTYPE_STRING, an array |
|
* of char* to the string values is returned. |
|
* This array has to be freed by the caller ! |
|
* @param valueBase Returns an absolute pointer to the base of value, | * @param valueBase Returns an absolute pointer to the base of value, |
* because subsequent pointers in the value are NOT | * because subsequent pointers in the value are NOT |
* resolved. | * resolved. |
|
|
* The value has to be copied by the caller ! | * The value has to be copied by the caller ! |
* @param name The property name | * @param name The property name |
* @param pvalue Returns a pointer to the value of property. | * @param pvalue Returns a pointer to the value of property. |
* The value has to be copied by the caller ! |
* The value is strored in a SCMBUnion |
|
* and has to be copied by the caller ! |
* It returns NULL if rc != SCMO_OK. | * It returns NULL if rc != SCMO_OK. |
|
* |
* If the value is an array, the | * If the value is an array, the |
* value array is stored in continuous memory. | * value array is stored in continuous memory. |
* e.g. If the CIMType is CIMTYPE_UINT32: |
* e.g. (SCMBUnion*)value[0 to size-1] |
* value = (void*)Uint32[0 to size-1] |
* |
* If it is an array of CIMTYPE_STRING, an array |
* If the value is type of CIMTYPE_STRING, |
* of char* to the string values is returned. |
* the string is referenced by the structure |
* This array has to be freed by the caller ! |
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
|
* Only for strings the caller has to free pvalue ! |
* @param type Returns the CIMType of the property | * @param type Returns the CIMType of the property |
* It is invalid if rc == SCMO_NOT_FOUND. | * It is invalid if rc == SCMO_NOT_FOUND. |
* @param isArray Returns if the value is an array. | * @param isArray Returns if the value is an array. |
|
|
SCMO_RC getProperty( | SCMO_RC getProperty( |
const char* name, | const char* name, |
CIMType& type, | CIMType& type, |
const void** pvalue, |
const SCMBUnion** pvalue, |
Boolean& isArray, | Boolean& isArray, |
Uint32& size ) const; | Uint32& size ) const; |
| |
|
|
* be set/replaced. | * be set/replaced. |
* @param name The name of the property to be set. | * @param name The name of the property to be set. |
* @param type The CIMType of the property | * @param type The CIMType of the property |
* @param value A pointer to property value. |
* @param value A pointer to the value to be set at the named property. |
|
* The value has to be in a SCMBUnion. |
* The value is copied into the instance | * The value is copied into the instance |
* If the value == NULL, a null value is assumed. | * If the value == NULL, a null value is assumed. |
* If the value is an array, the |
* If the value is an array, the value array has to be |
* value array must be stored in continuous memory. |
* stored in continuous memory. |
* e.g. If the CIMType is CIMTYPE_UINT32: |
* e.g. (SCMBUnion*)value[0 to size-1] |
* value = (void*)Uint32[0 to size-1] |
* |
|
* To store an array of size 0, The value pointer has to |
|
* not NULL ( value != NULL ) but the size has to be 0 |
|
* (size == 0). |
|
* |
|
* If the value is type of CIMTYPE_STRING, |
|
* the string is referenced by the structure |
|
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
* @param isArray Indicate that the value is an array. Default false. | * @param isArray Indicate that the value is an array. Default false. |
* @param size Returns the size of the array. If not an array this | * @param size Returns the size of the array. If not an array this |
* this parameter is ignorer. Default 0. | * this parameter is ignorer. Default 0. |
|
|
SCMO_RC setPropertyWithOrigin( | SCMO_RC setPropertyWithOrigin( |
const char* name, | const char* name, |
CIMType type, | CIMType type, |
void* value, |
SCMBUnion* value, |
Boolean isArray=false, | Boolean isArray=false, |
Uint32 size = 0, | Uint32 size = 0, |
const char* origin = NULL); | const char* origin = NULL); |
|
|
* is still SCMO_OK. | * is still SCMO_OK. |
* @param index The node index. | * @param index The node index. |
* @param type The CIMType of the property | * @param type The CIMType of the property |
* @param value A pointer to property value. |
* @param pInVal A pointer to the value to be set at the named property. |
|
* The value has to be in a SCMBUnion. |
* The value is copied into the instance | * The value is copied into the instance |
* If the value is an array, the |
* If the value == NULL, a null value is assumed. |
* value array must be stored in continuous memory. |
* If the value is an array, the value array has to be |
* e.g. If the CIMType is CIMTYPE_UINT32: |
* stored in continuous memory. |
* value = (void*)Uint32[0 to size-1] |
* e.g. (SCMBUnion*)value[0 to size-1] |
|
* |
|
* To store an array of size 0, The value pointer has to |
|
* not NULL ( value != NULL ) but the size has to be 0 |
|
* (size == 0). |
|
* |
|
* If the value is type of CIMTYPE_STRING, |
|
* the string is referenced by the structure |
|
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
* @param isArray Indicate that the value is an array. Default false. | * @param isArray Indicate that the value is an array. Default false. |
* @param size The size of the array. If not an array this | * @param size The size of the array. If not an array this |
* this parameter is ignorer. Default 0. | * this parameter is ignorer. Default 0. |
|
|
SCMO_RC setPropertyWithNodeIndex( | SCMO_RC setPropertyWithNodeIndex( |
Uint32 node, | Uint32 node, |
CIMType type, | CIMType type, |
void* value, |
SCMBUnion* pInVal, |
Boolean isArray=false, | Boolean isArray=false, |
Uint32 size = 0); | Uint32 size = 0); |
| |
|
|
* @param keyvalue A pointer to the binary key value. | * @param keyvalue A pointer to the binary key value. |
* The value is copied into the instance | * The value is copied into the instance |
* If the value == NULL, a null value is assumed. | * If the value == NULL, a null value is assumed. |
|
* @param keyvalue A pointer to the value to be set at the key binding, |
|
* The keyvalue has to be in a SCMBUnion. |
|
* The keyvalue is copied into the instance. |
|
* If the keyvalue == NULL, a null value is assumed. |
|
* |
|
* If the keyvalue is type of CIMTYPE_STRING, |
|
* the string is referenced by the structure |
|
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
* @return SCMO_OK | * @return SCMO_OK |
* SCMO_INVALID_PARAMETER : Given name or pvalue | * SCMO_INVALID_PARAMETER : Given name or pvalue |
* is a NULL pointer. | * is a NULL pointer. |
|
|
SCMO_RC setKeyBinding( | SCMO_RC setKeyBinding( |
const char* name, | const char* name, |
CIMType type, | CIMType type, |
void* keyvalue); |
SCMBUnion* keyvalue); |
| |
/** | /** |
* Set/replace the key binding at node | * Set/replace the key binding at node |
* @param node The node index of the key. | * @param node The node index of the key. |
* @param type The type as CIMType. | * @param type The type as CIMType. |
* @param keyvalue A pointer to the binary key value. |
* @param keyvalue A pointer to the value to be set at the key binding, |
* The value is copied into the instance |
* The keyvalue has to be in a SCMBUnion. |
* If the value == NULL, a null value is assumed. |
* The keyvalue is copied into the instance. |
|
* If the keyvalue == NULL, a null value is assumed. |
|
* |
|
* If the keyvalue is type of CIMTYPE_STRING, |
|
* the string is referenced by the structure |
|
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
* @return SCMO_OK | * @return SCMO_OK |
* SCMO_INVALID_PARAMETER : Given pvalue is a NULL pointer. | * SCMO_INVALID_PARAMETER : Given pvalue is a NULL pointer. |
* SCMO_TYPE_MISSMATCH : Given type does not | * SCMO_TYPE_MISSMATCH : Given type does not |
|
|
SCMO_RC setKeyBindingAt( | SCMO_RC setKeyBindingAt( |
Uint32 node, | Uint32 node, |
CIMType type, | CIMType type, |
void* keyvalue); |
SCMBUnion* keyvalue); |
| |
/** | /** |
* Gets the key binding count. | * Gets the key binding count. |
|
|
Uint32 idx, | Uint32 idx, |
const char** pname, | const char** pname, |
CIMType& type, | CIMType& type, |
const void** keyvalue) const; |
const SCMBUnion** keyvalue) const; |
| |
/** | /** |
* Get the named key binding. | * Get the named key binding. |
* @parm name The name of the key binding. | * @parm name The name of the key binding. |
* @param type Returns the type as CIMType. | * @param type Returns the type as CIMType. |
* It is invalid if rc == SCMO_INDEX_OUT_OF_BOUND. | * It is invalid if rc == SCMO_INDEX_OUT_OF_BOUND. |
|
* @param keyvalue Returns a pointer to the value of keybinding. |
|
* The value is strored in a SCMBUnion |
|
* and has to be copied by the caller ! |
|
* It returns NULL if rc != SCMO_OK. |
|
* |
|
* If the value is type of CIMTYPE_STRING, |
|
* the string is referenced by the structure |
|
* SCMBUnion.extString: |
|
* pchar contains the absolut pointer to the string |
|
* length contains the size of the string |
|
* without trailing '\0'. |
|
* Only for strings the caller has to free pvalue ! |
* @param keyvalue A pointer to the binary key value. | * @param keyvalue A pointer to the binary key value. |
* Has to be copied by caller. | * Has to be copied by caller. |
* It is only valid if rc == SCMO_OK. | * It is only valid if rc == SCMO_OK. |
|
|
SCMO_RC getKeyBinding( | SCMO_RC getKeyBinding( |
const char* name, | const char* name, |
CIMType& ptype, | CIMType& ptype, |
const void** keyvalue) const; |
const SCMBUnion** keyvalue) const; |
| |
/** | /** |
* Determines whether the object has been initialized. | * Determines whether the object has been initialized. |
|
|
Uint32 pos, | Uint32 pos, |
const char** pname, | const char** pname, |
CIMType& type, | CIMType& type, |
const void** pvalue, |
const SCMBUnion** pvalue, |
Boolean& isArray, | Boolean& isArray, |
Uint32& size ) const; | Uint32& size ) const; |
| |
void _setPropertyAtNodeIndex( | void _setPropertyAtNodeIndex( |
Uint32 pos, | Uint32 pos, |
CIMType type, | CIMType type, |
void* value, |
SCMBUnion* pInVal, |
Boolean isArray, | Boolean isArray, |
Uint32 size); | Uint32 size); |
| |
|
|
| |
void _setCIMObjectPath(const CIMObjectPath& cimObj); | void _setCIMObjectPath(const CIMObjectPath& cimObj); |
| |
void* _resolveSCMBUnion( |
SCMBUnion* _resolveSCMBUnion( |
CIMType type, | CIMType type, |
Boolean isArray, | Boolean isArray, |
Uint32 size, | Uint32 size, |
|
|
char* base) const; | char* base) const; |
| |
void _setSCMBUnion( | void _setSCMBUnion( |
void* value, |
SCMBUnion* pInVal, |
CIMType type, | CIMType type, |
Boolean isArray, | Boolean isArray, |
Uint32 size, | Uint32 size, |
SCMBUnion & u); | SCMBUnion & u); |
| |
static void _setUnionValue( |
static void _setNonRefUnionValue( |
Uint64 start, | Uint64 start, |
SCMBMgmt_Header** pmem, | SCMBMgmt_Header** pmem, |
CIMType type, | CIMType type, |