scds_get_zone_name (3HA)

名称

scds_get_zone_name - 检索运行某个方法时所代表的区域的名称

用法概要

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>
     const char *scds_get_zone_name(scds_handle_t handle);

描述

scds_get_zone_name() 函数可返回指向字符串的指针。如果满足以下条件，此字符串将包含在其中运行资源组的区域的名称：

• 从全局区域调用 scds_get_zone_name 函数。

• 已将 Global_zone 资源类型属性设置为 TRUE。

  有关 Global_zone 资源类型属性的信息，请参见 rt_properties(5) 手册页。

• 已在区域群集中配置资源。

在其他所有情况（包括以下情况）下，字符串为 NULL：

• 资源组在全局区域中进行配置。

• Global_zone 资源类型属性设置为 FALSE，或者 Global_zone_override 资源属性设置为 FALSE。

要获取实际上正在其中执行某个方法的区域的名称，请使用 zonename 命令。请参见 zonename(1) 手册页。

字符串的指针指向属于数据服务开发库 (Data Service Development Library, DSDL) 的内存。请勿修改此内存。调用 scds_close() 会使此指针失效。

参数

支持以下参数：

handle

从 scds_initialize(3HA) 返回的句柄。

错误

SCHA_ERR_NOERR

该函数成功。

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

文件

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

头文件

/usr/cluster/lib/libdsdev.so

库

属性

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

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

另请参见

zonename(1)、scds_close(3HA)、scds_initialize(3HA)、scha_calls(3HA)、attributes(5)、rt_properties(5)