RegistryPropertySet10

RegistryPropertySet

RegistryPropertySet sets the value of a property in the Name Registry.

OSStatus RegistryPropertySet (
                     const RegEntryID *entryID,
                     const RegPropertyName *propertyName,
                     const void *propertyValue,
                     RegPropertyValueSize propertySize);

--> entryID

Pointer to the RegEntryID value that identifies a name entry.

--> propertyName

Pointer to the name of the property. For computers built prior to the iMac, this value cannot exceed 4 bytes. For the iMac and later Macintosh models, this value cannot exceed 8 bytes.

--> propertyValue

Pointer to the value to which to set the property.

--> propertySize

Pointer to the size in bytes of the property. For computers built prior to the iMac, this value cannot exceed 8 bytes. For the iMac and later Macintosh models, this value cannot exceed 32 bytes.

DESCRIPTION

RegistryPropertySet sets the value of the property named propertyName and associated with the name entry identified by entryID. The propertySize parameter must be set to the size (in bytes) of the value pointed to by propertyValue.

EXECUTION CONTEXT

RegistryPropertySet may be called from task level only, not from secondary interrupt level or hardware interrupt level. This restriction is due to the fact that a call to RegistryPropertySet allocates memory in NVRAM.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Bad parameter
`nrLockedErr`	-2536	Entry or property locked
`nrNotEnoughMemoryErr`	-2537	Not enough space in the system heap
`nrInvalidNodeErr`	-2538	`RegEntryID` value not valid
`nrNotFoundErr`	-2539	Search failed to match criteria
`nrNameErr`	-2541	Name invalid, too long, or not terminated
`nrOverrunErr`		This error is only possible if the property has the `kRegPropertyValueIsSavedToNVRAM` modifier
`nrTypeMismatchErr`		This error is only possible if the property has the `kRegPropertyValueIsSavedToNVRAM` modifier