scds_get_rs_hostnames (3HA)

名称

scds_get_rs_hostnames - 获取某一资源所使用的网络资源

用法概要

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>
     scha_err_t scds_get_rs_hostnames(scds_handle_t 
     handle,scds_net_resource_list_t **netresource_list);

描述

scds_get_rs_hostnames() 函数检索资源所使用的主机名列表。如果设置了资源属性 Network_resources_used ，则主机名与 Network_resources_used 中列出的网络资源相对应。否则，它们对应于包含该资源的资源组中的所有网络资源。

该函数返回一个指向 netresource_list 中的列表的指针。资源组可以不包含任何网络资源，也可以包含不使用网络资源的资源，因此该函数会返回设置为 NULL 的 netresource_list。

使用 scds_free_net_list(3HA) 释放由此函数分配并返回的内存。

参数

支持以下参数

handle

从 scds_initialize(3HA) 返回的句柄

netresource_list

资源组所使用的网络资源的列表

返回值

scds_get_rs_hostnames() 函数返回以下值：

0

该函数成功

non-zero

该函数失败

错误

SCHA_ERR_NOERR

函数成功。

有关其他错误代码的描述，请参见 scha_calls(3HA)。

文件

/usr/cluster/include/rgm/libdsdev.h

头文件

/usr/cluster/lib/libdsdev.so

库

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 ha-cluster/developer/api 接口稳定性 Evolving（发展中）

另请参见

scds_free_net_list(3HA), scds_get_rg_hostnames(3HA ), scds_initialize(3HA), scha_calls(3HA), attributes(5), r_properties(5)