PR_GetUniqueIdentity

请求运行时为由图层名称标识的图层分配一个唯一标识。

语法

#include <prio.h>

PRDescIdentity PR_GetUniqueIdentity(const char *layer_name);

参数

该函数具有以下参数

layer_name

与创建图层标识关联的字符串。

返回值

该函数返回以下值之一

• 如果成功，则返回与名为 layer_name 的字符串关联的图层的 PRDescIdentity。

• 如果函数无法分配足够的动态内存，则失败并返回 PR_INVALID_IO_LAYER 值，错误代码为 PR_OUT_OF_MEMORY_ERROR。

描述

在创建图层时，可以将字符串与图层关联。PR_GetUniqueIdentity 分配一个唯一的图层标识并将其与字符串关联。随后，该字符串可以传递给 PR_CreateIOLayerStub 以创建该图层的新文件描述符。

对于任何特定的图层名称，只调用一次 PR_GetUniqueIdentity。如果您正在创建自定义 I/O 图层，请缓存结果，然后在每次调用 PR_CreateIOLayerStub 时使用该缓存结果。