Function

CFURLSetResourcePropertyForKey

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

Declaration

Boolean CFURLSetResourcePropertyForKey(CFURLRef url, CFStringRef key, CFTypeRef propertyValue, CFErrorRef *error);

Parameters

url

The URL.

key

The name of one of the URL’s resource properties.

propertyValue

The value for the resource property defined by key.

error

The error that occurred if the resource value could not be set.

Return Value

true if the resource property named key is successfully set to value; otherwise, false.

Discussion

This function synchronously writes the new resource value out to disk. Attempts to set a read-only resource property or to set a resource property that is not supported by the resource are ignored and are not considered errors.

If an error occurs, this method returns false and populates the object pointer referenced by error with additional information.

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.

CFURLSetTemporaryResourcePropertyForKey

Sets a temporary resource value on the URL.