xdr_wrapstring Subroutine

AIX Version 4.3 Communications Technical Reference, Volume 1

xdr_wrapstring Subroutine

Purpose

Calls the xdr_string subroutine.

Library

C Library (libc.a)

Syntax

#include <rpc/xdr.h>

xdr_wrapstring (xdrs, sp)
XDR *xdrs;
char **sp;

Description

The xdr_wrapstring subroutine is a primitive that calls the xdr_string subroutine (xdrs, sp, MAXUN.UNSIGNED), where the MAXUN.UNSIGNED value is the maximum value of an unsigned integer. The xdr_wrapstring subroutine is useful because the Remote Procedure Call (RPC) package passes a maximum of two eXternal Data Representation (XDR) subroutines as parameters, and the xdr_string subroutine requires three.

Parameters

xdrs	Points to the XDR stream handle.
sp	Specifies the address of the pointer to the string.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The xdr_string subroutine.

List of XDR Programming References.

eXternal Data Representation (XDR) Overview for Programming in AIX Communications Programming Concepts.

Understanding XDR Library Filter Primitives in AIX Communications Programming Concepts.