OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_rpc_get_error_descriptor - Acquire the descriptor of an asynchronous response-type RPC request which has encountered an error

Format

ANSI C, C++

#include <dcrpc.h>
int dc_rpc_get_error_descriptor(DCLONG flags)

K&R C

#include <dcrpc.h>
int dc_rpc_get_error_descriptor (flags)
DCLONG     flags

Description

The function dc_rpc_get_error_descriptor() acquires the descriptor of an asynchronous response-type RPC request which has encountered an error when it is called just after the function dc_rpc_poll_any_replies() without a particular asynchronous response specified returns with an error.

It can acquire the descriptor only when the error has occurred on the SPP.

If an error has occurred on the dc_rpc_poll_any_replies() caller, the function dc_rpc_get_error_descriptor() cannot acquire the descriptor.

Arguments whose value is set in the UAP

flags

Specify DCNOFLAGS.

Return values

Return value Return value (numeric) Explanation
Positive integer The function acquired the descriptor of the asynchronous response-type RPC request which encountered the error returned by the function dc_rpc_poll_any_replies().
0 The function failed to acquire the descriptor of the asynchronous response-type RPC request which encountered the error returned by the function dc_rpc_poll_any_replies().
DCRPCER_INVALID_ARGS -301 The value specified for the argument is invalid.