RpcBindingInqOption function (rpcdce.h)

Article
02/22/2024

RPC client processes use RpcBindingInqOption to determine current values of the binding options for a given binding handle.

Syntax

RPC_STATUS RpcBindingInqOption(
  RPC_BINDING_HANDLE hBinding,
  unsigned long      option,
  ULONG_PTR          *pOptionValue
);

Parameters

hBinding

Server binding about which to determine binding-option values.

option

Binding handle property to inquire about.

pOptionValue

Memory location to place the value for the specified Option

Note For a list of binding options and their possible values, see Binding Option Constants.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.
RPC_S_CANNOT_SUPPORT	The function is not supported for either the operating system or the transport.

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

Remarks

Client processes call RpcBindingInqOption to determine the current settings of the binding handle options. To inquire about authentication settings clients call the RpcBindingInqAuthClient function. .

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