Funzione RpcAsyncInitializeHandle (rpcasync.h)

Articolo
03/01/2024

Il client chiama la funzione RpcAsyncInitializeHandle per inizializzare la struttura di RPC_ASYNC_STATE da usare per eseguire una chiamata asincrona.

Sintassi

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

Parametri

pAsync

Puntatore alla struttura RPC_ASYNC_STATE che contiene informazioni sulla chiamata asincrona.

Size

Dimensioni della struttura RPC_ASYNC_STATE .

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_ARG	La dimensione è troppo piccola o troppo grande.
RPC_S_INVALID_ASYNC_HANDLE	pAsync punta alla memoria non valida.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Il client crea una nuova struttura RPC_ASYNC_STATE e un puntatore a tale struttura e chiama RpcAsyncInitializeHandle con il puntatore come parametro di input. La funzione RpcAsyncInitializeHandle inizializza i campi usati per mantenere lo stato di una chiamata remota asincrona. Quando la chiamata a RpcAsyncInitializeHandle restituisce correttamente, il client può impostare il tipo di notifica e tutti i campi correlati al tipo di notifica nella struttura RPC_ASYNC_STATE . L'applicazione client usa un puntatore a questa struttura per effettuare una chiamata asincrona.

Il client non deve tentare di modificare i membri Size, Signature, Lock e StubInfo della struttura RPC_ASYNC_STATE ; in questo modo verrà invalidato l'handle.

Nota In Windows 2000, dopo il completamento di una chiamata asincrona, la struttura RPC_ASYNC_STATE deve essere reinizializzata prima di essere usata per un'altra chiamata asincrona. In Windows XP e versioni successive, la struttura RPC_ASYNC_STATE è pronta per la ripetizione immediata successiva a una chiamata asincrona completata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rpcasync.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll