struct _CMPIBrokerMemFT

This structure is a table of pointers to memory specific  CIMOM services.

Documentation

This structure is a table of pointers to memory specific  CIMOM services. This table is made available by the Management Broker, whenever a provider is loaded and initialized. This is an extension used by CIMOMs to support memory management enhancements.

[more]CMPIGcStat* (*mark)(const CMPIBroker* mb, CMPIStatus* rc)
Returns a marker.
[more]CMPIStatus (*release)(const CMPIBroker* mb, const CMPIGcStat* gc)
Release all CMPI objects created since last mark() operation represented by the parameter.
[more]void* (*cmpiMalloc)(const CMPIBroker* mb, size_t size)
Allocates uninitalized memory of the specified size.
[more]void* (*cmpiCalloc)(const CMPIBroker* mb, size_t, size_t)
This function shall return a pointer to the allocated memory, the memory will be initialized to zero.
[more]void* (*cmpiRealloc)(const CMPIBroker* mb, void* , size_t)
This function changes the size of the memory block pointed to by ptr which must have been returned by a previous call to cmpiMalloc or cmpiCalloc.
[more]char* (*cmpiStrDup)(const CMPIBroker* mb, const char* )
This function returns a pointer to a new string which is a duplicate of the string src.
[more]void (*cmpiFree)(const CMPIBroker* mb, void* )
This function frees memory allocated via the cmpiMalloc, cmpiCalloc or cmpiRealloc functions.
[more]void (*freeInstance)(const CMPIBroker* mb, CMPIInstance* inst)
Allows a MI to free memory associated to a CMPIinstance which was allocated via CMPIBrokerEncFTnewInstance.
[more]void (*freeObjectPath)(const CMPIBroker* mb, CMPIObjectPath* obj)
Allows a MI to free memory associated to a CMPIArgs which was allocated via CMPIBrokerEncFTnewArgs.
[more]void (*freeArgs)(const CMPIBroker* mb, CMPIArgs* args)
Allows a MI to free memory associated to a CMPIArgs which was allocated via CMPIBrokerEncFTnewArgs.
[more]void (*freeString)(const CMPIBroker* mb, CMPIString* str)
Allows a MI to free memory associated to a CMPIString which was allocated via CMPIBrokerEncFTnewString.
[more]void (*freeArray)(const CMPIBroker* mb, CMPIArray* array)
Allows a MI to free memory associated to a CMPIArray which was allocated via CMPIBrokerEncFTnewArray.
[more]void (*freeDateTime)(const CMPIBroker* mb, CMPIDateTime* date)
Allows a MI to free memory associated to a CMPIDateTime which was allocated via CMPIBrokerEncFTnewDateTime functions.
[more]void (*freeSelectExp)(const CMPIBroker* mb, CMPISelectExp* se)
Allows a MI to free memory associated to a CMPISelectExp which was allocated via CMPIBrokerEncFTnewSelectExp functions.

oCMPIGcStat* (*mark)(const CMPIBroker* mb, CMPIStatus* rc)
Returns a marker. Invoking this function marks subsequent newly created CMPI objects to be released when release() function is invoked. Note: mark() functions can be stacked.
Parameters:
mb - The broker.
- rc Output: Service return status (suppressed when NULL).
Returns:
Handle to be provided to releae() function. á

oCMPIStatus (*release)(const CMPIBroker* mb, const CMPIGcStat* gc)
Release all CMPI objects created since last mark() operation represented by the parameter. release() functions can be stacked.
Parameters:
mb - The broker.
gc - The handle returned from the mark() operation.
Returns:
Service return status.

ovoid* (*cmpiMalloc)(const CMPIBroker* mb, size_t size)
Allocates uninitalized memory of the specified size.
Parameters:
mb - Specifies the broker.
- ásize Specifies the amount of memory to allocate.
Returns:
Returns a pointer to the allocated memory, or NULL if the memory could not be allocated

ovoid* (*cmpiCalloc)(const CMPIBroker* mb, size_t, size_t)
This function shall return a pointer to the allocated memory, the memory will be initialized to zero.
Parameters:
mb - The broker.
nElems - The number of elements to allocate.
sizeElem - The number of elements to allocate.
Returns:
Returns a pointer to the allocated memory, or NULL if the memory could not be allocated

ovoid* (*cmpiRealloc)(const CMPIBroker* mb, void* , size_t)
This function changes the size of the memory block pointed to by ptr which must have been returned by a previous call to cmpiMalloc or cmpiCalloc. See the ANSI-C function realloc for more information
Parameters:
mb - the broker.
ptr - Pointer to previosuly allocated memory. Passing a pointer to this function which was not allocated explicitly by cmpiMalloc or cmpiCalloc is undefined.
size - The new size of the memory block.
Returns:
Returns a pointer to the newly allocated memory block, or NULL if the new memory is not allcoated. If the function fals nothing is done with the original ptr argument.

ochar* (*cmpiStrDup)(const CMPIBroker* mb, const char* )
This function returns a pointer to a new string which is a duplicate of the string src.
Parameters:
mb - The broker
src - The string to duplicate
Returns:
a pointer to the duplicated string, or NULL if insufficient memory was available.

ovoid (*cmpiFree)(const CMPIBroker* mb, void* )
This function frees memory allocated via the cmpiMalloc, cmpiCalloc or cmpiRealloc functions.
Parameters:
- ámb The broker.
ptr - The memory to free. This memory MUST have been allocated via the cmpiMalloc, cmpiCalloc or cmpiRealloc functions.
Returns:
None

ovoid (*freeInstance)(const CMPIBroker* mb, CMPIInstance* inst)
Allows a MI to free memory associated to a CMPIinstance which was allocated via CMPIBrokerEncFTnewInstance. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects (e.g. properties).
Parameters:
mb - the broker. @parma inst The instance to free.
Returns:
None

ovoid (*freeObjectPath)(const CMPIBroker* mb, CMPIObjectPath* obj)
Allows a MI to free memory associated to a CMPIArgs which was allocated via CMPIBrokerEncFTnewArgs. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects.
Parameters:
mb - the broker.
obj - The object path to free.
Returns:
None

ovoid (*freeArgs)(const CMPIBroker* mb, CMPIArgs* args)
Allows a MI to free memory associated to a CMPIArgs which was allocated via CMPIBrokerEncFTnewArgs. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects.
Parameters:
mb - the broker.
args - The argument to free.
Returns:
None.

ovoid (*freeString)(const CMPIBroker* mb, CMPIString* str)
Allows a MI to free memory associated to a CMPIString which was allocated via CMPIBrokerEncFTnewString. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects.
Parameters:
mb - the broker.
args - The string to free.
Returns:
None.

ovoid (*freeArray)(const CMPIBroker* mb, CMPIArray* array)
Allows a MI to free memory associated to a CMPIArray which was allocated via CMPIBrokerEncFTnewArray. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects (e.g. the array elements).
Parameters:
mb - the broker.
args - The string to free.
Returns:
None.

ovoid (*freeDateTime)(const CMPIBroker* mb, CMPIDateTime* date)
Allows a MI to free memory associated to a CMPIDateTime which was allocated via CMPIBrokerEncFTnewDateTime functions. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects.
Parameters:
mb - the broker.
args - The string to free.
Returns:
None.

ovoid (*freeSelectExp)(const CMPIBroker* mb, CMPISelectExp* se)
Allows a MI to free memory associated to a CMPISelectExp which was allocated via CMPIBrokerEncFTnewSelectExp functions. this function should be called when an instance is no longer being used by the MI. This function will free all contained objects.
Parameters:
mb - the broker.
args - The string to free.
Returns:
None.

Alphabetic index