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_SUCCESS

returned 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.2RhGetDomainNumbers

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.

46

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

Page 46
Image 46
Intel ZT 4901 manual RhGetDomainNumbers, Handle Handle of the current session PCount, System