catclose 子例程
用途
关闭指定的消息目录。
库
标准 C 库 (libc.a)
语法
#include <nl_types.h>
int catclose ( CatalogDescriptor)
nl_catd CatalogDescriptor;
nl_catd CatalogDescriptor;
描述
catclose 子例程关闭指定的消息目录。 如果您的程序访问多个消息目录，并且达到最大打开目录数 (由 NL_MAXOPEN 常量指定) ，那么必须先关闭某些目录，然后再打开其他目录。 如果使用文件描述符来实现 nl_catd 数据类型，那么 catclose 子例程将关闭该文件描述符。
仅当 catclose 子例程接收到的调用数与应用程序中对 catopen 子例程的调用总数匹配时，它才会关闭消息目录。 当关闭消息目录时，先前对 catgets 子例程的调用所获取的所有消息缓冲区指针都无效。
参数
| 项 | 描述 |
|---|---|
| CatalogDescriptor | 指向从对 catopen 子例程的调用返回的消息目录。 |
返回值
如果 catclose 子例程成功关闭目录，或者如果它接收的调用数少于对 catopen 子例程的调用数，那么它将返回值 0。
如果catclose子程序没有成功关闭目录，则返回值为-1。 The 关闭 subroutine is unsuccessful if the number of calls it receives is greater than the number of calls to the 猫开 subroutine, or if the value of the CatalogDescriptor parameter is not valid.