ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference

 


DRContentProperties.h

Includes:
<CoreFoundation/CoreFoundation.h>
<AvailabilityMacros.h>

Overview

Property strings for filesystem objects.



Constants


kDRAbstractFile


(ISO/Joliet) The key for indicating the abstract file.

extern const CFStringRef kDRAbstractFile;  
Discussion

Value is a DRFileRef (which must be in the root directory).

Availability
Introduced in Mac OS X v10.2

kDRAccessDate


The property key for the item's last-accessed date.

extern const CFStringRef kDRAccessDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRAllFilesystems


The key for accessing the name or properties for the file in all filesystems together.

extern const CFStringRef kDRAllFilesystems;  
Discussion

When this key is used to refer to a name, it refers to the base name (which has no naming restrictions).

Availability
Introduced in Mac OS X v10.2

kDRApplicationIdentifier


(ISO/Joliet) The key for indicating the application identifier.

extern const CFStringRef kDRApplicationIdentifier;  
Discussion

Value is a CFStringRef. Only the first 32 characters (ISO) or 16 characters (Joliet) will be used, after being mapped into a legal character set.

Availability
Introduced in Mac OS X v10.2

kDRAttributeModificationDate


The property key for the item's attribute modification date.

extern const CFStringRef kDRAttributeModificationDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRBackupDate


The property key for the item's backup date.

extern const CFStringRef kDRBackupDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRBibliographicFile


(ISO/Joliet) The key for indicating the bibliographic file.

extern const CFStringRef kDRBibliographicFile;  
Discussion

Value is a DRFileRef (which must be in the root directory).

Availability
Introduced in Mac OS X v10.2

kDRBlockSize


The key for indicating the block size of the track.

extern const CFStringRef kDRBlockSize;  
Discussion

Value is a CFNumberRef, currently always 2048. Do not change.

Availability
Introduced in Mac OS X v10.2

kDRContentModificationDate


The property key for the item's content modification date.

extern const CFStringRef kDRContentModificationDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRCopyrightFile


(ISO/Joliet) The key for indicating the copyright file.

extern const CFStringRef kDRCopyrightFile;  
Discussion

Value is a DRFileRef (which must be in the root directory).

Availability
Introduced in Mac OS X v10.2

kDRCreationDate


The property key for the item's creation date.

extern const CFStringRef kDRCreationDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRDataPreparer


(ISO/Joliet) The key for indicating the data preparer.

extern const CFStringRef kDRDataPreparer;  
Discussion

Value is a CFStringRef.

Availability
Introduced in Mac OS X v10.2

kDRDefaultDate


The default date for any unspecified dates in the filesystem.

extern const CFStringRef kDRDefaultDate;  
Discussion

Value is a CFDateRef. The current date and time is used if unspecified.

Availability
Introduced in Mac OS X v10.2

kDREffectiveDate


The property key for the item's effective date, the date at which the contents become valid.

extern const CFStringRef kDREffectiveDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRExpirationDate


The property key for the item's expiration date, the date at which the contents become no longer valid.

extern const CFStringRef kDRExpirationDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRHFSPlus


The key for accessing the HFS+ name/properties for the file.

extern const CFStringRef kDRHFSPlus;  
Discussion

HFS+ names can be up to 255 decomposed unicode characters long.

Availability
Introduced in Mac OS X v10.2

kDRHFSPlusCatalogNodeID


The property key for the item's catalog node ID (HFS+ only).

extern const CFStringRef kDRHFSPlusCatalogNodeID;  
Discussion

Value is a CFNumber. Currently, this value if set is only a suggestion. The burn engine will attempt to use this node ID, but may use another value if it needs to resolve conflicts. Default behavior is to allocate node IDs incrementally from kHFSFirstUserCatalogNodeID .

Availability
Introduced in Mac OS X v10.2

kDRHFSPlusTextEncodingHint


The property key for the item's text encoding hint (HFS+ only).

extern const CFStringRef kDRHFSPlusTextEncodingHint;  
Discussion

Value is a CFNumber. This value is used by the MacOS to help when converting the natively UTF-16 filename into an 8-bit-per-character representation (such as MacRoman, Shift-JIS, or UTF8). If not set, default behavior is to call CFStringGetMostCompatibleMacStringEncoding (CFStringGetSmallestEncoding ()).

Availability
Introduced in Mac OS X v10.2

kDRInvisible


The property key for the invisibility of the object.

extern const CFStringRef kDRInvisible;  
Discussion

Value is a CFBooleanRef.

Availability
Introduced in Mac OS X v10.2

kDRISO9660


The key for accessing the ISO-9660 properties for the file.

extern const CFStringRef kDRISO9660;  
Discussion

This key is used to refer specifically to the properties for the file.

This key cannot be used to refer to the name of the file; it is ambiguous, since the name may be in either level 1 or level 2 format.

Availability
Introduced in Mac OS X v10.2

kDRISO9660LevelOne


The key for accessing the ISO-9660 level 1 name for the file.

extern const CFStringRef kDRISO9660LevelOne;  
Discussion

This key is used to refer specifically to the name generated for ISO-9660 if the ISO level is set to 1. When used for a property, it is equivalent in use to the kDRISO9660 key and acts as a synonym for that key.

ISO9660 level 1 names are in the form typically known as 8.3 - eight characters of name and three characters of extension (if it's a file; directories can't have extensions). Character set is limited to A-Z, 0-9, and _.

Availability
Introduced in Mac OS X v10.2

kDRISO9660LevelTwo


The key for accessing the ISO-9660 level 2 name for the file.

extern const CFStringRef kDRISO9660LevelTwo;  
Discussion

This key is used to refer specifically to the name generated for ISO-9660 if the ISO level is set to 2. When used for a property, it is equivalent in use to the kDRISO9660 key and acts as a synonym for that key.

ISO9660 level 2 names can be 32 chars long, are limited to a subset of the 7-bit ASCII chars (capital letters, numbers, space, punctuation), and are only allowed one "." character.

Availability
Introduced in Mac OS X v10.2

kDRISO9660VersionNumber


The property key for the ISO9660 version number for the object.

extern const CFStringRef kDRISO9660VersionNumber;  
Discussion

Value is a CFNumber, default value is 1.

Availability
Introduced in Mac OS X v10.2

kDRISOLevel


The key for indicating the ISO level of the ISO-9660 filesystem on the track.

extern const CFStringRef kDRISOLevel;  
Discussion

Value is a CFNumberRef, currently should be 1 or 2.

Availability
Introduced in Mac OS X v10.2

kDRISOMacExtensions


(ISO/Joliet) Whether to add ISO/Joliet Mac extensions when appropriate.

extern const CFStringRef kDRISOMacExtensions;  
Discussion

Value is a CFBooleanRef.

Availability
Introduced in Mac OS X v10.2

kDRISORockRidgeExtensions


(ISO/Joliet) Whether to add RockRidge (POSIX extensions) when appropriate.

extern const CFStringRef kDRISORockRidgeExtensions;  
Discussion

Value is a CFBooleanRef.

Availability
Introduced in Mac OS X v10.2

kDRJoliet


The key for accessing the Joliet name/properties for the file.

extern const CFStringRef kDRJoliet;  
Discussion

Joliet names can be 64 precomposed unicode characters long, but are only allowed one "." character and many punctuation characters are illegal.

Availability
Introduced in Mac OS X v10.2

kDRMacExtendedFinderFlags


The property key for the item's extended Finder flags (MacOS only).

extern const CFStringRef kDRMacExtendedFinderFlags;  
Discussion

Value is a CFNumber.

Availability
Introduced in Mac OS X v10.2

kDRMacFileCreator


The property key for a file's creator (MacOS only).

extern const CFStringRef kDRMacFileCreator;  
Discussion

Value is a CFDataRef containing an OSType.

Availability
Introduced in Mac OS X v10.2

kDRMacFileType


The property key for a file's type (MacOS only).

extern const CFStringRef kDRMacFileType;  
Discussion

Value is a CFDataRef containing an OSType.

Availability
Introduced in Mac OS X v10.2

kDRMacFinderFlags


The property key for the item's Finder flags (MacOS only).

extern const CFStringRef kDRMacFinderFlags;  
Discussion

Value is a CFNumber. The "invisible" bit is ignored - use kDRInvisible instead.

Availability
Introduced in Mac OS X v10.2

kDRMacFinderHideExtension


The property key for hiding the extension of the object.

extern const CFStringRef kDRMacFinderHideExtension;  
Discussion

A CFBooleanRef indicating whether the extension should be hidden in the Finder or not. The default is false and only applies to files.

Availability
Introduced in Mac OS X v10.5.

kDRMacIconLocation


The property key for the item's icon location in its parent folder (MacOS only).

extern const CFStringRef kDRMacIconLocation;  
Discussion

Value is a CFDataRef containing a Point.

Availability
Introduced in Mac OS X v10.2

kDRMacScrollPosition


The property key for the folder's scroll position (MacOS only).

extern const CFStringRef kDRMacScrollPosition;  
Discussion

Value is a CFDataRef containing a Point.

Availability
Introduced in Mac OS X v10.2

kDRMacWindowBounds


The property key for the window bounds for a folder (MacOS only).

extern const CFStringRef kDRMacWindowBounds;  
Discussion

Value is a CFDataRef containing a Rect.

Availability
Introduced in Mac OS X v10.2

kDRMacWindowView


The property key for the folder's window view (MacOS only).

extern const CFStringRef kDRMacWindowView;  
Discussion

Value is a CFNumber.

Availability
Introduced in Mac OS X v10.2

kDRPosixFileMode


The posix file mode.

extern const CFStringRef kDRPosixFileMode;  
Discussion

Value is a CFNumber.

Availability
Introduced in Mac OS X v10.2

kDRPosixGID


The posix file GID.

extern const CFStringRef kDRPosixGID;  
Discussion

Value is a CFNumber.

Availability
Introduced in Mac OS X v10.2

kDRPosixUID


The posix file UID.

extern const CFStringRef kDRPosixUID;  
Discussion

Value is a CFNumber.

Availability
Introduced in Mac OS X v10.2

kDRPublisher


(ISO/Joliet) The key for indicating the publisher string.

extern const CFStringRef kDRPublisher;  
Discussion

Value is a CFStringRef.

Availability
Introduced in Mac OS X v10.2

kDRRecordingDate


The property key for the item's recording date.

extern const CFStringRef kDRRecordingDate;  
Discussion

Value is a CFDateRef.

Availability
Introduced in Mac OS X v10.2

kDRSuppressMacSpecificFiles


Whether to suppress Mac-specific files from non-HFS filesystems.

extern const CFStringRef kDRSuppressMacSpecificFiles;  
Discussion

Value is a CFBooleanRef.

Availability
Introduced in Mac OS X v10.3.

kDRSystemIdentifier


(ISO/Joliet) The key for indicating the system identifier.

extern const CFStringRef kDRSystemIdentifier;  
Discussion

Value is a CFStringRef. Only the first 32 characters (ISO) or 16 characters (Joliet) will be used, after being mapped into a legal character set. Note, this value will NOT be used if Mac extensions are turned on - with Mac extensions, the system identifier will always be "APPLE COMPUTER, INC., TYPE: 0002"

Availability
Introduced in Mac OS X v10.2

kDRUDF


The key for accessing the UDF name/properties for the file.

extern const CFStringRef kDRUDF;  

Availability
Introduced in Mac OS X v10.4.

kDRUDFApplicationIdentifierSuffix


extern const CFStringRef kDRUDFApplicationIdentifierSuffix;  
Discussion

Optional key. A CFData object containing at most 8 bytes of data. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFExtendedFilePermissions


Optional key. Specifies the extended UDF file permissions of this file.

extern const CFStringRef kDRUDFExtendedFilePermissions;  
Discussion

Value is a CFNumberRef. Bit 0: Change attributes for others (low order bit) Bit 1: Delete permissions for others Bit 2: Change attributes for group Bit 3: Delete permissions for group Bit 4: Change attributes for owner Bit 5: Delete permissions for owner Bit 6 & 7: Reserved If this key is not present, kDRPosixFileMode will be used with the above bits being set to the corresponding write bit for owner, group, and others. If kDRPosixFileMode is not present, the file mode from the file on disc will be used, again using the write bit for these permissions.

Availability
Introduced in Mac OS X v10.4.

kDRUDFInterchangeLevel


extern const CFStringRef kDRUDFInterchangeLevel;  
Discussion

Optional key. This property key defines the volume interchange level. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFMaxInterchangeLevel


extern const CFStringRef kDRUDFMaxInterchangeLevel;  
Discussion

Optional key. This property key defines the maximum volume interchange level number. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFMaxVolumeSequenceNumber


extern const CFStringRef kDRUDFMaxVolumeSequenceNumber;  
Discussion

Optional key. This property key defines the maximum volume sequence number. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFPrimaryVolumeDescriptorNumber


extern const CFStringRef kDRUDFPrimaryVolumeDescriptorNumber;  
Discussion

Optional key. This property key defines the primary volume sequence number. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFRealTimeFile


Optional key. Specifies whether this file is to be marked as a UDF Real-Time file.

extern const CFStringRef kDRUDFRealTimeFile;  
Discussion

Value is a CFBooleanRef.

Availability
Introduced in Mac OS X v10.4.

kDRUDFVersion102


extern const CFStringRef kDRUDFVersion102;  
Discussion

This value is used in kDRUDFWriteVersion .

Availability
Introduced in Mac OS X v10.4.

kDRUDFVersion150


extern const CFStringRef kDRUDFVersion150;  
Discussion

This value is used in kDRUDFWriteVersion .

Availability
Introduced in Mac OS X v10.4.

kDRUDFVolumeSequenceNumber


extern const CFStringRef kDRUDFVolumeSequenceNumber;  
Discussion

Optional key. This property key defines the volume sequence number. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFVolumeSetIdentifier


extern const CFStringRef kDRUDFVolumeSetIdentifier;  
Discussion

Optional key. The Volume Set Identifier for the UDF volume set. If this key is not present, kDRVolumeSet will be used if present. The Volume Set Identifier is composed of the Volume Set Timestamp, the Implementation Use, and a the string contained in this property.

Availability
Introduced in Mac OS X v10.4.

kDRUDFVolumeSetImplementationUse


extern const CFStringRef kDRUDFVolumeSetImplementationUse;  
Discussion

Optional key. A CFData object containing at most 8 bytes of data. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFVolumeSetTimestamp


extern const CFStringRef kDRUDFVolumeSetTimestamp;  
Discussion

Optional key. See the UDF specs for details.

Availability
Introduced in Mac OS X v10.4.

kDRUDFWriteVersion


extern const CFStringRef kDRUDFWriteVersion;  
Discussion

Optional key. This property key defines the version for the UDF structures written to disk. Values are definde in UDF Version types.

Availability
Introduced in Mac OS X v10.4.

kDRVolumeCheckedDate


(HFS+) The key for indicating the volume-checked date.

extern const CFStringRef kDRVolumeCheckedDate;  
Discussion

Value is a CFDateRef. kDRDefaultDate is used if unspecified.

Availability
Introduced in Mac OS X v10.2

kDRVolumeCreationDate


The key for indicating the volume creation date.

extern const CFStringRef kDRVolumeCreationDate;  
Discussion

Value is a CFDateRef. kDRDefaultDate is used if unspecified.

Availability
Introduced in Mac OS X v10.2

kDRVolumeEffectiveDate


(ISO/Joliet) The date and time at which the volume is effective.

extern const CFStringRef kDRVolumeEffectiveDate;  
Discussion

Value is a CFDateRef. Empty if unspecified.

Availability
Introduced in Mac OS X v10.2

kDRVolumeExpirationDate


(ISO/Joliet) The date and time at which the volume expires.

extern const CFStringRef kDRVolumeExpirationDate;  
Discussion

Value is a CFDateRef. Empty if unspecified.

Availability
Introduced in Mac OS X v10.2

kDRVolumeModificationDate


The key for indicating the volume modification date.

extern const CFStringRef kDRVolumeModificationDate;  
Discussion

Value is a CFDateRef. kDRDefaultDate is used if unspecified.

Availability
Introduced in Mac OS X v10.2

kDRVolumeSet


(ISO/Joliet) The key for indicating the volume set name.

extern const CFStringRef kDRVolumeSet;  
Discussion

Value is a CFStringRef.

Availability
Introduced in Mac OS X v10.2


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.
Last Updated: 2008-04-01