xdr_reference 子例程

在线编辑

用途

提供结构内的指针跟踪。

库

C 库 (libc.a)

语法

#include <rpc/xdr.h>
xdr_reference ( xdrs,  pp,  size,  proc)
XDR *xdrs;
char **pp;
u_int size;
xdrproc_t proc;

描述

xdr_reference 子例程是一个过滤器原语，用于在结构中提供指针追逐。 此原语允许将一个结构中的被另一个结构引用的任何指针序列化、反序列化和释放。

xdr_reference 子例程在序列化期间不会将特殊含义附加到空指针。 尝试传递空指针的地址可能会导致内存错误。 程序员必须使用两手区分的联合来描述数据。 一个臂在指针有效时使用; 另一个臂在指针为空时使用。

参数

项 描述
xdrs 指向 eXternal 数据表示 (XDR) 流句柄。
Pp 指定指向结构的指针的地址。 解码数据时，如果指针为空，那么 XDR 会分配存储器。
大小 指定 pp 参数指向的结构的字节大小。
proc 转换其 C 格式与外部表示之间的结构。 此参数是描述结构的 XDR 过程。

返回值

成功完成时，此子例程返回值 1。 如果失败，那么将返回值 0。