某些 API 方法为异步方法,这意味着,此类方法返回时,其执行的操作可能没有完成。异步方法将返回一个句柄,您可查询该句柄以查看操作状态。某些操作的状态信息可能包括完成的百分比。
查询异步操作时,其结果可为以下类型之一:
- DriveAdd:系统正在将驱动器添加到集群中。
- BulkVolume:系统正在卷之间执行复制操作,例如备份或还原。
- Clone:系统正在克隆卷。
- DriveRemoval:系统正在从驱动器中复制数据,准备将其从集群中删除。
- RtfiPendingNode:系统正在节点上安装兼容软件,以便稍后将其添加到集群中。
使用异步方法或获取正在运行的异步操作的状态时,请注意以下几点:
- 各个方法文档中有对异步方法的说明。
- 异步方法会返回“asyncHandle”,此句柄可由发出此句柄的 API 方法识别。您可以使用此句柄轮询异步操作的状态或结果。
- 您可以使用 GetAsyncResult 方法获取各个异步方法的结果。使用 GetAsyncResult 查询已完成的操作时,系统将返回此结果并自动从系统中清除此结果。使用 GetAsyncResult 查询未完成的操作时,系统将返回此结果,但不会将其清除。
- 您可以使用 ListAsyncResults 方法获取所有正在运行或已完成的异步方法的状态和结果。在这种情况下,系统不会清除已完成操作的结果。