Export (0) Print
Expand All

IRpcOptions interface

Enables callers to set or query the values of various properties that control how COM handles remote procedure calls (RPC).

When to implement

You do not need to implement this interface. It is provided by all standard COM proxies.

When to use

Use this interface when you want to set or query the value of the RPC communications time-out property or when you want to determine the degree of remoteness of an RPC counterpart.

Members

The IRpcOptions interface inherits from the IUnknown interface. IRpcOptions also has these types of members:

Methods

The IRpcOptions interface has these methods.

MethodDescription
Query

Retrieves the value of an RPC binding option property.

Set

Sets the value of an RPC binding option property.

 

Remarks

Using this interface, callers can set or query the COMBND_RPCTIMEOUT property, which controls how long your machine will attempt to establish RPC communications with another before failing. The property can have any one of the values enumerated in the following table.

ValueDescription
RPC_C_BINDING_INFINITE_TIMEOUT Keep trying to establish communications with no timeout.
RPC_C_BINDING_MIN_TIMEOUT Try to establish communications for the minimum time required by the protocol. This value favors performance over reliability.
RPC_C_BINDING_DEFAULT_TIMEOUT Try to establish communications for the default time. The value strikes a balance between performance and reliability.
RPC_C_BINDING_MAX_TIMEOUT Try to establish communications for the maximum time allowed by the protocol. This value favors reliability over performance.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IRpcOptions is defined as 00000144-0000-0000-C000-000000000046

 

 

Community Additions

ADD
Show:
© 2014 Microsoft