本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。
异步方法
贡献者
建议更改
某些 API 方法是异步的,这意味着,当方法返回时,它们执行的操作可能不完整。异步方法返回一个句柄,您可以查询该句柄以查看操作状态;某些操作的状态信息可能包括完成百分比。
查询异步操作时,其结果可以是以下类型之一:
-
DriveAdd
:系统正在向集群添加驱动器。 -
BulkVolume
:系统正在卷之间执行复制操作,例如备份或还原。 -
Clone
:系统正在克隆卷。 -
DriveRemoval
:系统正在从驱动器中复制数据,以准备将其从群集中删除。 -
RtfiPendingNode
:系统正在将某个节点添加到集群之前在该节点上安装兼容软件。
使用异步方法或获取正在运行的异步操作的状态时,请注意以下几点:
-
异步方法在各个方法文档中均有说明。
-
异步方法返回 "`asyncHandle` " ,此句柄可由发出 API 的方法识别。您可以使用句柄轮询异步操作的状态或结果。
-
您可以使用 GetAsyncResult 方法获取各个异步方法的结果。使用 GetAsyncResult 查询已完成的操作时,系统将返回结果并自动从系统中清除结果。使用 GetAsyncResult 查询未完成的操作时,系统将返回结果,但不会将其清除。
-
您可以使用 ListAsyncResults 方法获取所有正在运行或已完成的异步方法的状态和结果。在这种情况下,系统不会清除已完成操作的结果。