Metodo IRpcOptions::Query (objidlbase.h)

  • Articolo

Recupera il valore di una proprietà dell'opzione di associazione RPC.

Sintassi

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

Parametri

[in] pPrx

Puntatore al proxy la cui proprietà viene sottoposta a query.

[in] dwProperty

Identificatore della proprietà su cui eseguire query, che deve essere COMBND_RPCTIMEOUT o COMBND_SERVER_LOCALITY (questo flag è disponibile a partire da Windows Server 2003).

[out] pdwValue

Puntatore al valore della proprietà.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Commenti

Anche se la proprietà COMBND_RPCTIMEOUT può essere impostata anche usando il metodo Set , è possibile eseguire query solo sulla proprietà COMBND_SERVER_LOCALITY.

Vedere IRpcOptions per una tabella dei valori possibili della proprietà COMBND_RPCTIMEOUT.

I valori possibili della proprietà COMBND_SERVER_LOCALITY, che descrive il grado di distanza della connessione RPC, vengono enumerati nella tabella seguente.

Valore Descrizione
SERVER_LOCALITY_PROCESS_LOCAL La controparte è nello stesso processo del client.
SERVER_LOCALITY_MACHINE_LOCAL La controparte si trova nello stesso computer del client, ma in un processo diverso.
SERVER_LOCALITY_REMOTE La controparte si trova in un computer remoto.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione objidlbase.h (include ObjIdl.h)

Vedi anche

IRpcOptions