Redundant Host API

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 a correct value to assist the caller in subsequent buffer allocation.

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 hosts that comprise the RH system. Each host 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 pHostNumbersArray parameter. The parameter ArraySize should be set equal to the size of the buffer in uint32 items. The host count returned from “RhGetHostCount” can be used as the value of this parameter. On return, the function populates the buffer with the array of host numbers for all hosts in the system, and places the actual number of returned host 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.11RhGetHostName

Prototype:

HSI_STATUS

RhGetHostName(

IN RH_HANDLE Handle,

IN uint32 Host,

OUT char *pOutHostName,

IN uint32 HostNameLength,

OUT ULONG *pActualSize );

Arguments:

 

Handle

the handle of the current session

Host

the host number

pOutHostName

pointer to the character buffer where the host name is stored as a null-

 

terminated character string

HostNameLength

the size of the buffer; if this size is too small for the output, this function

 

fails.

pActualSize -

this variable receives the actual size of the returned host name; in the

 

case of the error code HSI_STATUS_INSUFFICIENT_BUFFER

 

returned, this is the minimal required size of the buffer.

Return Value:

HSI_STATUS_SUCCESS

returned in the case of success

HSI_STATUS_INVALID_PARAMETER invalid session handle

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

53

Page 53
Image 53
Intel ZT 4901 manual RhGetHostName, Hsistatusinsufficientbuffer