rpcAsyncInitializeHandle 函式 (rpcasync.h)
用戶端會呼叫 RpcAsyncInitializeHandle 函式，初始化要用來進行異步呼叫 的RPC_ASYNC_STATE 結構。
語法
RPC_STATUS RpcAsyncInitializeHandle(
PRPC_ASYNC_STATE pAsync,
unsigned int Size
);
參數
pAsync
包含異步呼叫資訊的 RPC_ASYNC_STATE 結構的指標。
Size
RPC_ASYNC_STATE 結構的大小。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
|
大小太小或太大。 |
|
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 |