op_pro_valid()

摘要

判断一个过程句柄是否指向有效且存在的进程(即该过程句柄不是作为内核过程出错的标志而获得的句柄,且其所指向的进程尚未被销毁)。

语法

op_pro_valid (pro_handle)
参数 类型 说明
pro_handle Prohandle 待检验有效性的过程句柄

返回类型

Boolean

布尔值,指示该过程句柄是否指向有效且未被销毁的进程。若过程句柄无效则返回 OPC_FALSE;若句柄有效则返回 OPC_TRUE。

示例

/* Loop through the child process list. */
for (i = 0; i < op_prg_list_size (process_list_ptr); i++)
	{
	/* Obtain the i_th process descriptor. */
	pd_ptr = op_prg_list_access (process_list_ptr, i);

	/* If the process is no longer active, remove it from the list. */
	if (op_pro_valid (pd_ptr->pro_handle) == OPC_FALSE)
		{
		op_prg_list_remove (process_list_ptr, i--);
		
		/* If under odb, issue a statement indicating the removal to the user. */
		if (op_prg_odb_ltrace_active ("process management"))
			{
			/* Note that the process id can’t be obtained from the handle, */
			/* because the process is already destroyed.                   */
			sprintf (str, "Deleting dead process (%d)", pd_ptr->pro_id);
			op_prg_odb_print_minor (str, OPC_NIL);
			}
		}

详情

自动创建的进程和动态创建的进程的过程句柄都可以通过 Pro 包中的多种内核过程获取。获取到的过程句柄可以存储在状态变量、临时变量或全局变量中,供其他内核过程使用。

这些过程句柄是用户声明的数据结构(而非指针),可能因以下三种原因而失效:

  1. 过程句柄已声明但从未初始化,其内容未定义。
  2. 过程句柄被用于接收某个内核过程的返回值,而该内核过程使过程句柄失效,以向调用者表明内核过程执行过程中发生了错误。
  3. 过程句柄曾经有效指向某个进程,但该进程此后已通过内核过程 op_pro_destroy() 被销毁。

内核过程 op_pro_valid() 能够确切判断过程句柄是否因上述原因 (2) 或 (3) 而失效,若失效则返回 OPC_FALSE。但对于情形 (1),由于句柄的内容是任意的,仅仅试图访问句柄本身的内容就可能发生致命错误。如果过程句柄指向一个已正确创建且仍然存在的进程,该内核过程将返回 OPC_TRUE。

用途

该内核过程允许对过程句柄进行有效性检验,这对许多不同应用都很重要。该内核过程的一个主要用途是在把过程句柄作为内核过程调用的参数之前检查其是否有效。另一个重要用途是检验返回类型为 Prohandle 的内核过程所返回的过程句柄;这类内核过程中的许多会在执行出错时把过程句柄置为无效状态。因此,在有理由认为某个内核过程可能无法成功完成时,可用 op_pro_valid() 验证某些其他内核过程的执行情况。

错误

  • 程序中止:段违例。(由于进程句柄格式错误)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com