46 High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification
Redundant Host API
Handle – the handle of the current session
pCount – pointer to the variable that receives the current number of domains in the
system
Return Value:
HSI_STATUS_SUCCESSreturned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function returns the number of domains in the RH system that can be owned by the hosts in
the system.
6.2.3.2 RhGetDomainNumbers
Prototype:
HSI_STATUS
RhGetDomainNumbers(
IN RH_HANDLE Handle,
OUT uint32 *pDomainNumbersArray,
IN uint32 ArraySize,
OUT uint32 *pActualSize );
Arguments:
Handle – the handle of the current session
pDomainNumbersArray – pointer to the array where the list of domain numbers is placed
ArraySize - the size (in items of type uint32) of the buffer initially provided for the
array by the caller
pActualSize - pointer to the variable where the actual number of items in the list is
stored (even if the initial size is too small and the function returns the
error HSI_STATUS_INSUFFICIENT_BUFFER).
Return Value:
HSI_STATUS_SUCCESS returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle
HSI_STATUS_INSUFFICIENT_BUFFER
returned if the buffer provided for the array by the caller is too small; in
that case, the array isn’t filled in but the location pointed by pActualSize
is set to the correct value to assist the caller in subsequent buffer
allocation.