RpcBindingSetObject function (rpcdce.h)

Article
02/22/2024

The RpcBindingSetObject function sets the object UUID value in a binding handle.

Syntax

RPC_STATUS RpcBindingSetObject(
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Parameters

Binding

Server binding into which the ObjectUuid is set.

ObjectUuid

Pointer to the UUID of the object serviced by the server specified in the Binding parameter. ObjectUuid is a unique identifier of an object to which a remote procedure call can be made.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.
RPC_S_INVALID_BINDING	The binding handle was invalid.
RPC_S_WRONG_KIND_OF_BINDING	This was the wrong kind of binding for the operation.

Note For a list of valid error codes, see RPC Return Values.

Remarks

An application calls the RpcBindingSetObject function to associate an object UUID with a server binding handle. The set-object operation replaces the previously associated object UUID with the UUID in the ObjectUuid parameter.

To set the object UUID to the nil UUID, specify a null value or the nil UUID for the ObjectUuid parameter.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps \| UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps \| UWP apps]
Target Platform	Windows
Header	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll