RpcAsyncInitializeHandle, fonction (rpcasync.h)

Article
06/03/2024

Le client appelle la fonction RpcAsyncInitializeHandle pour initialiser la structure RPC_ASYNC_STATE à utiliser pour effectuer un appel asynchrone.

Syntaxe

C++

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

Paramètres

pAsync

Pointeur vers la structure RPC_ASYNC_STATE qui contient des informations d’appel asynchrones.

Size

Taille de la structure RPC_ASYNC_STATE .

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_ARG	La taille est trop petite ou trop grande.
RPC_S_INVALID_ASYNC_HANDLE	pAsync pointe vers une mémoire non valide.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Remarques

Le client crée une structure RPC_ASYNC_STATE et un pointeur vers cette structure et appelle RpcAsyncInitializeHandle avec le pointeur comme paramètre d’entrée. La fonction RpcAsyncInitializeHandle initialise les champs qu’elle utilise pour conserver l’état d’un appel distant asynchrone. Lorsque l’appel à RpcAsyncInitializeHandle est retourné avec succès, le client peut définir le type de notification et tous les champs associés à ce type de notification dans la structure RPC_ASYNC_STATE . L’application cliente utilise un pointeur vers cette structure pour effectuer un appel asynchrone.

Le client ne doit pas tenter de modifier les membres Size, Signature, Lock et StubInfo de la structure RPC_ASYNC_STATE ; Cela invalidera le handle.

Note Dans Windows 2000, une fois qu’un appel asynchrone est terminé, la structure RPC_ASYNC_STATE doit être réinitialisée avant d’être utilisée pour un autre appel asynchrone. Dans Windows XP et versions ultérieures, la structure RPC_ASYNC_STATE est prête pour une réutilisation immédiate après un appel asynchrone terminé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	rpcasync.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll