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

Article
02/29/2024

Récupère la valeur d’une propriété d’option de liaison RPC.

Syntaxe

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

Paramètres

[in] pPrx

Pointeur vers le proxy dont la propriété est interrogée.

[in] dwProperty

Identificateur de la propriété à interroger, qui doit être COMBND_RPCTIMEOUT ou COMBND_SERVER_LOCALITY (cet indicateur est disponible à partir de Windows Server 2003.)

[out] pdwValue

Pointeur vers la valeur de propriété.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

Bien que la propriété COMBND_RPCTIMEOUT puisse également être définie à l’aide de la méthode Set , la propriété COMBND_SERVER_LOCALITY peut uniquement être interrogée.

Consultez IRpcOptions pour obtenir un tableau des valeurs possibles de la propriété COMBND_RPCTIMEOUT.

Les valeurs possibles de la propriété COMBND_SERVER_LOCALITY, qui décrit le degré de distance de la connexion RPC, sont énumérées dans le tableau suivant.

Valeur	Description
SERVER_LOCALITY_PROCESS_LOCAL	L’équivalent est dans le même processus que le client.
SERVER_LOCALITY_MACHINE_LOCAL	L’équivalent se trouve sur le même ordinateur que le client, mais dans un processus différent.
SERVER_LOCALITY_REMOTE	L’équivalent se trouve sur un ordinateur distant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objidl.h (inclure ObjIdl.h)

Voir aussi

IRpcOptions

Partager via