IRpcOptions::Query method

Retrieves the value of an RPC binding option property.

Syntax


HRESULT Query(
  [in]  IUnknown  *pPrx,
  [in]  DWORD     dwProperty,
  [out] ULONG_PTR *pdwValue
);

Parameters

pPrx [in]

A pointer to the proxy whose property is being queried.

dwProperty [in]

An identifier of the property to be queried, which must be COMBND_RPCTIMEOUT or COMBND_SERVER_LOCALITY (this flag is available starting with Windows Server 2003.)

pdwValue [out]

A pointer to the property value.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Remarks

While the COMBND_RPCTIMEOUT property can also be set using the Set method, the COMBND_SERVER_LOCALITY property can only be queried.

See IRpcOptions for a table of the possible values of the COMBND_RPCTIMEOUT property.

The possible values of the COMBND_SERVER_LOCALITY property, which describes the degree of remoteness of the RPC connection, are enumerated in the following table.

ValueDescription
SERVER_LOCALITY_PROCESS_LOCAL The counterpart is in the same process as the client.
SERVER_LOCALITY_MACHINE_LOCAL The counterpart is on the same computer as the client but in a different process.
SERVER_LOCALITY_REMOTE The counterpart is on a remote computer.

 

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

See also

IRpcOptions

 

 

Show: