IRpcOptions::Query-Methode (objidlbase.h)
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) |