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() 函数检索资源所使用的主机名列表。如果资源声明了对任何网络资源的显式依赖关系，则主机名对应于这些网络资源。否则，它们对应于包含该资源的资源组中的所有网络资源。

该函数返回一个指向 netresource_list 中的列表的指针。资源可以没有任何网络资源依赖项，并且其资源组可以不包含任何网络资源，因此该函数可能返回设置为 NULL 的 netresource_list。

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

参数

支持以下参数

handle

从 scds_initialize(3HA) 返回的句柄

netresource_list

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

返回值

scds_get_rs_hostnames() 函数返回以下值：

0

该函数成功

非零值

该函数失败

错误

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)