Compartilhar via


Método IRpcOptions::Query (objidl.h)

Recupera o valor de uma propriedade de opção de associação RPC.

Sintaxe

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

Parâmetros

[in] pPrx

Um ponteiro para o proxy cuja propriedade está sendo consultada.

[in] dwProperty

Um identificador da propriedade a ser consultada, que deve ser COMBND_RPCTIMEOUT ou COMBND_SERVER_LOCALITY (esse sinalizador está disponível a partir do Windows Server 2003.)

[out] pdwValue

Um ponteiro para o valor da propriedade.

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

Embora a propriedade COMBND_RPCTIMEOUT também possa ser definida usando o método Set , a propriedade COMBND_SERVER_LOCALITY só pode ser consultada.

Consulte IRpcOptions para obter uma tabela dos valores possíveis da propriedade COMBND_RPCTIMEOUT.

Os valores possíveis da propriedade COMBND_SERVER_LOCALITY, que descreve o grau de remoteness da conexão RPC, são enumerados na tabela a seguir.

Valor Descrição
SERVER_LOCALITY_PROCESS_LOCAL O equivalente está no mesmo processo que o cliente.
SERVER_LOCALITY_MACHINE_LOCAL O equivalente está no mesmo computador que o cliente, mas em um processo diferente.
SERVER_LOCALITY_REMOTE O equivalente está em um computador remoto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h (inclua ObjIdl.h)

Confira também

IRpcOptions