Gets the string associated with a layer's unique identity.
Syntax
#include <prio.h> const char* PR_GetNameForIdentity(PRDescIdentity ident);
Parameter
The function has the following parameter:
ident
- A layer's identity.
Returns
The function returns one of the following values:
- If successful, the function returns a pointer to the string associated with the specified layer.
- If unsuccessful, the function returns
NULL
.
Description
A string may be associated with a layer when the layer is created. The string is copied by the runtime, and PR_GetNameForIdentity
returns a pointer to that copy.