Convert a DOFObjectID into its standard string representation.
- Resource Management:
- This function allocates resources that must later be freed by calling PCRMem_Free. The standardized Object ID string format is described in the DOF Common Types document.
- Note
- The output is a null-terminated, readable string suitable for output in debug or log messages.
- Parameters
-
self | The DOFObjectID to convert. This should not be NULL. |
- Returns
- Pointer to the newly generated string buffer.
- Exceptions
-
NULL | is returned if
- an invalid parameter is detected; or
- insufficient resources exist to create the string.
|