Function

CFURLSetTemporaryResourcePropertyForKey

Sets a temporary resource value on the URL.

Declaration

void CFURLSetTemporaryResourcePropertyForKey(CFURLRef url, CFStringRef key, CFTypeRef propertyValue);

Parameters

url

The URL.

key

The key where the value should be stored. This key must be unique and must not conflict with any system-defined keys. Reverse-domain-name notation is recommended.

propertyValue

The value to store.

Discussion

Your app can use a temporary resource value to temporarily store a value for an app-defined resource value key in memory without modifying the actual resource that the URL represents. Once set, you can copy the temporary resource value from the URL object just as you would copy system-defined keys—by calling CFURLCopyResourcePropertyForKey or CFURLCopyResourcePropertiesForKeys.

Your app can remove a temporary resource value from the URL object by calling CFURLClearResourcePropertyCacheForKey or CFURLClearResourcePropertyCache (to remove all temporary values).

This method is applicable only to URLs for file system resources.

See Also

Getting and Setting File System Resource Properties

CFURLClearResourcePropertyCache

Removes all cached resource values and temporary resource values from the URL object.

CFURLClearResourcePropertyCacheForKey

Removes the cached resource value identified by a given key from the URL object.

CFURLCopyResourcePropertiesForKeys

Returns the resource values for the properties identified by specified array of keys.

CFURLCopyResourcePropertyForKey

Returns the value of a given resource property of a given URL.

CFURLCreateResourcePropertiesForKeysFromBookmarkData

Returns the resource values for properties identified by a specified array of keys contained in specified bookmark data.

CFURLCreateResourcePropertyForKeyFromBookmarkData

Returns the value of a resource property from specified bookmark data.

CFURLSetResourcePropertiesForKeys

Sets the URL’s resource properties for a given set of keys to a given set of values.

CFURLSetResourcePropertyForKey

Sets the URL’s resource property for a given key to a given value.