Mac Developer Library

Developer

DRContentProperties.h Reference

Options
Deployment Target:

On This Page

DRContentProperties.h Reference

Property strings for filesystem objects.

Included Headers

  • <CoreFoundation/CoreFoundation.h>

  • <AvailabilityMacros.h>

Constants

See the Overview section above for header-level documentation.

  • Declaration

    extern const CFStringRef kDRAbstractFile; extern const CFStringRef kDRAccessDate; extern const CFStringRef kDRAllFilesystems; extern const CFStringRef kDRApplicationIdentifier; extern const CFStringRef kDRAttributeModificationDate; extern const CFStringRef kDRBackupDate; extern const CFStringRef kDRBibliographicFile; extern const CFStringRef kDRBlockSize; extern const CFStringRef kDRContentModificationDate; extern const CFStringRef kDRCopyrightFile; extern const CFStringRef kDRCreationDate; extern const CFStringRef kDRDataPreparer; extern const CFStringRef kDRDefaultDate; extern const CFStringRef kDREffectiveDate; extern const CFStringRef kDRExpirationDate; extern const CFStringRef kDRHFSPlus; extern const CFStringRef kDRHFSPlusCatalogNodeID; extern const CFStringRef kDRHFSPlusTextEncodingHint; extern const CFStringRef kDRInvisible; extern const CFStringRef kDRISO9660; extern const CFStringRef kDRISO9660LevelOne; extern const CFStringRef kDRISO9660LevelTwo; extern const CFStringRef kDRISO9660VersionNumber; extern const CFStringRef kDRISOLevel; extern const CFStringRef kDRISOMacExtensions; extern const CFStringRef kDRISORockRidgeExtensions; extern const CFStringRef kDRJoliet; extern const CFStringRef kDRMacExtendedFinderFlags; extern const CFStringRef kDRMacFileCreator; extern const CFStringRef kDRMacFileType; extern const CFStringRef kDRMacFinderFlags; extern const CFStringRef kDRMacFinderHideExtension; extern const CFStringRef kDRMacIconLocation; extern const CFStringRef kDRMacScrollPosition; extern const CFStringRef kDRMacWindowBounds; extern const CFStringRef kDRMacWindowView; extern const CFStringRef kDRPosixFileMode; extern const CFStringRef kDRPosixGID; extern const CFStringRef kDRPosixUID; extern const CFStringRef kDRPublisher; extern const CFStringRef kDRRecordingDate; extern const CFStringRef kDRSuppressMacSpecificFiles; extern const CFStringRef kDRSystemIdentifier; extern const CFStringRef kDRUDF; extern const CFStringRef kDRUDFApplicationIdentifierSuffix; extern const CFStringRef kDRUDFExtendedFilePermissions; extern const CFStringRef kDRUDFInterchangeLevel; extern const CFStringRef kDRUDFMaxInterchangeLevel; extern const CFStringRef kDRUDFMaxVolumeSequenceNumber; extern const CFStringRef kDRUDFPrimaryVolumeDescriptorNumber; extern const CFStringRef kDRUDFRealTimeFile; extern const CFStringRef kDRUDFVersion102; extern const CFStringRef kDRUDFVersion150; extern const CFStringRef kDRUDFVolumeSequenceNumber; extern const CFStringRef kDRUDFVolumeSetIdentifier; extern const CFStringRef kDRUDFVolumeSetImplementationUse; extern const CFStringRef kDRUDFVolumeSetTimestamp; extern const CFStringRef kDRUDFWriteVersion; extern const CFStringRef kDRVolumeCheckedDate; extern const CFStringRef kDRVolumeCreationDate; extern const CFStringRef kDRVolumeEffectiveDate; extern const CFStringRef kDRVolumeExpirationDate; extern const CFStringRef kDRVolumeModificationDate; extern const CFStringRef kDRVolumeSet;

    Constants

    • kDRAbstractFile

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

    • kDRAccessDate

      Value is a CFDateRef.

    • kDRAllFilesystems

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

    • kDRApplicationIdentifier

      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.

    • kDRAttributeModificationDate

      Value is a CFDateRef.

    • kDRBackupDate

      Value is a CFDateRef.

    • kDRBibliographicFile

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

    • kDRBlockSize

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

    • kDRContentModificationDate

      Value is a CFDateRef.

    • kDRCopyrightFile

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

    • kDRCreationDate

      Value is a CFDateRef.

    • kDRDataPreparer

      Value is a CFStringRef.

    • kDRDefaultDate

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

    • kDREffectiveDate

      Value is a CFDateRef.

    • kDRExpirationDate

      Value is a CFDateRef.

    • kDRHFSPlus

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

    • kDRHFSPlusCatalogNodeID

      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 .

    • kDRHFSPlusTextEncodingHint

      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 ()).

    • kDRInvisible

      Value is a CFBooleanRef.

    • kDRISO9660

      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.

    • kDRISO9660LevelOne

      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 _.

    • kDRISO9660LevelTwo

      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.

    • kDRISO9660VersionNumber

      Value is a CFNumber, default value is 1.

    • kDRISOLevel

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

    • kDRISOMacExtensions

      Value is a CFBooleanRef.

    • kDRISORockRidgeExtensions

      Value is a CFBooleanRef.

    • kDRJoliet

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

    • kDRMacExtendedFinderFlags

      Value is a CFNumber.

    • kDRMacFileCreator

      Value is a CFDataRef containing an OSType.

    • kDRMacFileType

      Value is a CFDataRef containing an OSType.

    • kDRMacFinderFlags

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

    • kDRMacFinderHideExtension

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

    • kDRMacIconLocation

      Value is a CFDataRef containing a Point.

    • kDRMacScrollPosition

      Value is a CFDataRef containing a Point.

    • kDRMacWindowBounds

      Value is a CFDataRef containing a Rect.

    • kDRMacWindowView

      Value is a CFNumber.

    • kDRPosixFileMode

      Value is a CFNumber.

    • kDRPosixGID

      Value is a CFNumber.

    • kDRPosixUID

      Value is a CFNumber.

    • kDRPublisher

      Value is a CFStringRef.

    • kDRRecordingDate

      Value is a CFDateRef.

    • kDRSuppressMacSpecificFiles

      Value is a CFBooleanRef.

    • kDRSystemIdentifier

      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" or "APPLE INC., TYPE: 0002"

    • kDRUDF

    • kDRUDFApplicationIdentifierSuffix

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

    • kDRUDFExtendedFilePermissions

      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.

    • kDRUDFInterchangeLevel

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

    • kDRUDFMaxInterchangeLevel

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

    • kDRUDFMaxVolumeSequenceNumber

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

    • kDRUDFPrimaryVolumeDescriptorNumber

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

    • kDRUDFRealTimeFile

      Value is a CFBooleanRef.

    • kDRUDFVersion102

      This value is used in kDRUDFWriteVersion .

    • kDRUDFVersion150

      This value is used in kDRUDFWriteVersion .

    • kDRUDFVolumeSequenceNumber

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

    • kDRUDFVolumeSetIdentifier

      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.

    • kDRUDFVolumeSetImplementationUse

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

    • kDRUDFVolumeSetTimestamp

      Optional key. See the UDF specs for details.

    • kDRUDFWriteVersion

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

    • kDRVolumeCheckedDate

      Value is a CFDateRef. kDRDefaultDate is used if unspecified.

    • kDRVolumeCreationDate

      Value is a CFDateRef. kDRDefaultDate is used if unspecified.

    • kDRVolumeEffectiveDate

      Value is a CFDateRef. Empty if unspecified.

    • kDRVolumeExpirationDate

      Value is a CFDateRef. Empty if unspecified.

    • kDRVolumeModificationDate

      Value is a CFDateRef. kDRDefaultDate is used if unspecified.

    • kDRVolumeSet

      Value is a CFStringRef.