PR_GetNameForIdentity

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.

Document Tags and Contributors

 Contributors to this page: teoli, alecananian
 Last updated by: teoli,