LayerAS_Layer
ObjectASUUID

An object containing data and methods supporting a universal unique identifier (UUID) for the current user or the current session.


Define Summary
 Define
 ASUUIDMaxStringLen
A constant for the maximum string length of a unique identifier (UUID).
Structure Summary
 Structure
 ASUUID
A structure representing a universal unique identifier (UUID) for the current user or the current session.
Method Summary
 Method
 
ASBool ASUUIDFromCString(ASUUID* dst, const char* str)
Parses a C string, such as one generated by ASUUIDToCString(), into a unique identifier (UUID).
 
ASBool ASUUIDGenFromHash(ASUUID* dst, ASUns8 hash)
Generates a unique identifier (UUID) from a hash value.
 
ASBool ASUUIDGenFromName(ASUUID* dst, const ASUUID* ns, void* name, ASByteCount bytes)
Generates a universal unique identifier (UUID) for a block of data (a name) in a context (a namespace).
 
ASBool ASUUIDGenUnique(ASUUID* dst)
Generates a unique identifier (UUID).
 
void ASUUIDToCString(char* dst, const ASUUID* src)
Generates a NULL-terminated C string from the unique identifier (UUID) for a user or session.
Defines Detail
ASUUIDMaxStringLen 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

#define ASUUIDMaxStringLen 40
Description

A constant for the maximum string length of a unique identifier (UUID).

See Also

ASUUIDToCString

File: ASExpT.h
Line: 3998



Structure Detail
ASUUID
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

struct ASUUID {
 ASUns32 timeLow; 
 
 ASUns16 timeMid; 
 
 ASUns16 timeHiAndVersion; 
 
 ASUns8 clockSeqHiAndReserved; 
 
 ASUns8 clockSeqLow; 
 
 ASUns8 node[6]; 
}

A structure representing a universal unique identifier (UUID) for the current user or the current session.


File: ASExpT.h
Line: 3978

Elements
timeLow  

Timestamp low field.

 
timeMid  

Timestamp middle field.

 
timeHiAndVersion  

Timestamp middle field multiplexed with the version number.

 
clockSeqHiAndReserved  

High field of the clock sequence multiplexed with the variant.

 
clockSeqLow  

Low field of the clock sequence.

 
node  

The spatially unique node identifier.


Method Detail
ASUUIDFromCString()
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

ASBool ASUUIDFromCString(ASUUID* dst, const char* str)

Parses a C string, such as one generated by ASUUIDToCString(), into a unique identifier (UUID).

Parameters

dst — 

(Filled by the method) The UUID created from the string.

 
str — 

A NULL-terminated string from which to generate the UUID, in the following form: f81d4fae-7dec-11d0-a765-00a0c91e6bf6.

Returns

true if the UUID is successfully created, false otherwise.

See Also

ASUUIDGenFromHash
ASUUIDGenFromName
ASUUIDGenUnique
ASUUIDToCString
AVAppGetUUID

Since

PI_ASEXTRA_VERSION >= 0x00060000

File: ASProcs.h
Line: 2190
ASUUIDGenFromHash() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

ASBool ASUUIDGenFromHash(ASUUID* dst, ASUns8 hash)

Generates a unique identifier (UUID) from a hash value.

Parameters

dst — 

(Filled by the method) The UUID created from the hash.

 
hash — 

A hash value, such as MD5.

Returns

true if the UUID is successfully created, false otherwise.

See Also

ASUUIDFromCString
ASUUIDGenFromName
ASUUIDGenUnique
ASUUIDToCString
AVAppGetUUID

Since

PI_ASEXTRA_VERSION >= 0x00060000

File: ASProcs.h
Line: 2173
ASUUIDGenFromName() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

ASBool ASUUIDGenFromName(ASUUID* dst, const ASUUID* ns, void* name, ASByteCount bytes)

Generates a universal unique identifier (UUID) for a block of data (a name) in a context (a namespace).

Parameters

dst — 

(Filled by the method) The UUID created from the name.

 
ns — 

A namespace or context meaningful to the client.
 
name — 

A pointer to an arbitrary block of data to be identified by the UUID.

 
bytes — 

The number of bytes in name.

Returns

true if the UUID is successfully created, false otherwise.

See Also

ASUUIDFromCString
ASUUIDGenFromHash
ASUUIDGenUnique
ASUUIDToCString
AVAppGetUUID

Since

PI_ASEXTRA_VERSION >= 0x00060000

File: ASProcs.h
Line: 2157
ASUUIDGenUnique() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

ASBool ASUUIDGenUnique(ASUUID* dst)

Generates a unique identifier (UUID).

Parameters

dst — 

(Filled by the method) The UUID created from the hash.

Returns

true if the UUID is successfully created, false otherwise.

See Also

ASUUIDFromCString
ASUUIDGenFromHash
ASUUIDGenFromName
ASUUIDToCString
AVAppGetUUID

Since

PI_ASEXTRA_VERSION >= 0x00060000

File: ASProcs.h
Line: 2137
ASUUIDToCString() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

void ASUUIDToCString(char* dst, const ASUUID* src)

Generates a NULL-terminated C string from the unique identifier (UUID) for a user or session.

Parameters

dst — 

(Filled by the method) A NULL-terminated string from which to generate the UUID, in the following form: f81d4fae-7dec-11d0-a765-00a0c91e6bf6. The string must be at least the length specified by ASUUIDMaxStringLen().
 
src — 

The UUID from which to generate the string .

See Also

ASUUIDFromCString
ASUUIDGenFromHash
ASUUIDGenFromName
ASUUIDGenUnique
AVAppGetUUID

Since

PI_ASEXTRA_VERSION >= 0x00060000

File: ASProcs.h
Line: 2208



Copyright 2020 Adobe Systems Incorporated and its licensors. All rights reserved. Adobe and the Adobe logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. This product contains either BSAFE and/or TIPEM software by RSA Security, Inc. Portions utilize Microsoft Windows Media Technologies. Copyright © 2006 Microsoft Corporation. All Rights Reserved. Notices, terms and conditions pertaining to other third party software are located at http://www.adobe.com/go/thirdparty/ and incorporated herein by reference.
Wed Feb 7 2024, 2:16 pm IST