Intel ZT 4901 manual RhGetDomainOwnership, RhGetDomainSlotPath

Redundant Host API

Other, implementation-defined HSI_STATUS values

returned if other errors occurred during execution of this function

Synopsis:

This function retrieves the list of numbers of known domains that comprise the RH system. Each domain number is an arbitrary uint32 value.

Before the call, the caller should allocate a buffer that can accommodate a sufficient number of uint32 values, and pass its address in the pDomainNumbersArray parameter. The parameter ArraySize should be set equal to the size of the buffer in uint32 items. The domain count returned from “RhGetDomainCount” can be used as the value of this parameter. On return, the function populates the buffer with the array of domain numbers for all domains in the system, and places the actual number of returned domain numbers into the output parameter *pActualSize. If the specified ArraySize is too small, the function returns status HSI_STATUS_INSUFFICIENT_BUFFER, and doesn’t populate the buffer, but still sets the parameter *pActualSize to the required size of the buffer.

6.2.3.3RhGetDomainOwnership

Prototype:

HSI_STATUS

RhGetDomainOwnership(

IN RH_HANDLE Handle,

IN uint32 Domain,

OUT uint32 *pOwningHost );

Arguments:
Handle –	the handle of the current session
Domain –	the domain number
pOwningHost	pointer to the variable that stores the number of the host (if any) that
	owns this domain; value RH_NO_DESTINATION_HOST means “not
	owned by any host”
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 current owning host for the specified domain.

6.2.3.4RhGetDomainSlotPath

Prototype:

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