Export (0) Print
Expand All
Expand Minimize

I_RpcBindingInqLocalClientPID function

[The I_RpcBindingInqLocalClientPID function is available for use in the operating systems specified in the Requirements section. Instead, call RpcServerInqCallAttributes.]

The I_RpcBindingInqLocalClientPID function obtains a client process ID.

Syntax


RPC_STATUS WINAPI I_RpcBindingInqLocalClientPID(
  _In_opt_  RPC_BINDING_HANDLE ClientBinding,
  _Out_     unsigned long *ClientPID
);

Parameters

ClientBinding [in, optional]

RPC_BINDING_HANDLE that specifies the binding handle for an explicit RPC binding from the client to a server application.

ClientPID [out]

Contains the process ID of the client that issued the call upon return.

Return value

ValueMeaning
RPC_S_OK

The function call was successful.

RPC_S_NO_CALL_ACTIVE

The current thread does not have an active RPC call.

RPC_S_INVALID_BINDING

The RPC binding handle is invalid.

 

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

Remarks

The client process ID is only returned in ClientBinding when the "ncalrpc" protocol sequence is used. Until the process terminates, the process ID value uniquely identifies it on the client. When the process terminates, the process ID can be used by new processes.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Rpcdcep.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft