rpcAsyncInitializeHandle 函式 (rpcasync.h)

發行項
03/05/2024

用戶端會呼叫 RpcAsyncInitializeHandle 函式，初始化要用來進行異步呼叫的RPC_ASYNC_STATE 結構。

語法

RPC_STATUS RpcAsyncInitializeHandle(
  PRPC_ASYNC_STATE pAsync,
  unsigned int     Size
);

參數

pAsync

包含異步呼叫資訊的 RPC_ASYNC_STATE 結構的指標。

Size

RPC_ASYNC_STATE 結構的大小。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_ARG	大小太小或太大。
RPC_S_INVALID_ASYNC_HANDLE	pAsync 指向無效的記憶體。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

備註

用戶端會建立新的 RPC_ASYNC_STATE 結構和該結構的指標，並使用指標作為輸入參數呼叫 RpcAsyncInitializeHandle 。 RpcAsyncInitializeHandle 函式會初始化用來維護異步遠端呼叫狀態的欄位。當 RpcAsyncInitializeHandle 的呼叫成功傳回時，用戶端可以設定通知類型和 與RPC_ASYNC_STATE 結構中該通知類型相關的任何字段。用戶端應用程式會使用此結構的指標進行異步呼叫。

用戶端不應該嘗試改變RPC_ASYNC_STATE結構的大小、簽章、鎖定和 StubInfo 成員;這麼做會使句柄失效。

注意在 Windows 2000 中，異步呼叫完成後，必須先重新初始化 RPC_ASYNC_STATE 結構，才能用於另一個異步呼叫。在 Windows XP 和更新版本中， RPC_ASYNC_STATE 結構已準備好在完成的異步呼叫之後立即重複使用。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	rpcasync.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll