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) |