IRpcOptions::Query-Methode (objidl.h)

Artikel
02/29/2024

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 abzufragbaren 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 mit der Set-Methode festgelegt werden kann, kann die COMBND_SERVER_LOCALITY-Eigenschaft nur abgefragt werden.

Unter IRpcOptions finden Sie eine Tabelle mit den möglichen Werten der COMBND_RPCTIMEOUT-Eigenschaft.

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	Das Pendant befindet sich im gleichen Prozess wie der Client.
SERVER_LOCALITY_MACHINE_LOCAL	Das Pendant befindet sich auf demselben Computer wie der Client, aber in einem anderen Prozess.
SERVER_LOCALITY_REMOTE	Das Pendant befindet sich auf einem Remotecomputer.

Anforderungen

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

Weitere Informationen

IRpcOptions

Freigeben über