IRpcOptions::Query-Methode (objidlbase.h)

Artikel
08/25/2023

Ruft den Wert einer RPC-Bindungsoptionseigenschaft ab.

Syntax

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

Parameter

[in] pPrx

Ein Zeiger auf den Proxy, dessen Eigenschaft abgefragt wird.

[in] dwProperty

Ein Bezeichner der abzufragten Eigenschaft, die COMBND_RPCTIMEOUT oder COMBND_SERVER_LOCALITY sein muss (dieses Flag ist ab Windows Server 2003 verfügbar.)

[out] pdwValue

Ein Zeiger auf den Eigenschaftswert.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.

Hinweise

Während die COMBND_RPCTIMEOUT-Eigenschaft auch mithilfe der Set-Methode festgelegt werden kann, kann die COMBND_SERVER_LOCALITY-Eigenschaft nur abgefragt werden.

Eine Tabelle mit den möglichen Werten der eigenschaft COMBND_RPCTIMEOUT finden Sie unter IRpcOptions .

Die möglichen Werte der COMBND_SERVER_LOCALITY-Eigenschaft, die den Grad der Remoteität der RPC-Verbindung beschreibt, werden in der folgenden Tabelle aufgelistet.

Wert	BESCHREIBUNG
SERVER_LOCALITY_PROCESS_LOCAL	Die Entsprechung befindet sich im gleichen Prozess wie der Client.
SERVER_LOCALITY_MACHINE_LOCAL	Die Entsprechung befindet sich auf demselben Computer wie der Client, aber in einem anderen Prozess.
SERVER_LOCALITY_REMOTE	Die Entsprechung befindet sich auf einem Remotecomputer.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	objidlbase.h (include ObjIdl.h)

Weitere Informationen

IRpcOptions

Share via