Universal URL Property Name Constants

Identify property values universal to all URLs.

#define kURLURL "URLString";
#define kURLResourceSize "URLResourceSize";
#define kURLLastModifiedTime "URLLastModifiedTime";
#define kURLMIMEType "URLMIMEType";
#define kURLFileType "URLFileType";
#define kURLFileCreator "URLFileCreator";
#define kURLCharacterSet "URLCharacterSet";
#define kURLResourceName "URLResourceName";
#define kURLHost "URLHost";
#define kURLAuthType "URLAuthType";
#define kURLUserName "URLUserName";
#define kURLPassword "URLPassword";
#define kURLStatusString "URLStatusString";
#define kURLIsSecure "URLIsSecure";
#define kURLCertificate "URLCertificate";
#define kURLTotalItems "URLTotalItems";

Constant descriptions

kURLURL

Identifies the name string property value. You use this name constant to obtain a C string that represents the URL.

kURLResourceSize

Identifies the resource size property value. You use this name constant to obtain a value of type Size that represents the total size of the data at the location specified by the URL.

kURLLastModifiedTime

Identifies the modification time property value. You use this name constant to obtain a value of type UInt32 that represents the last time the data was modified.

kURLMIMEType

Identifies the MIME type property value. You use this name constant to obtain a Pascal string that represents the MIME type of the URL.

kURLFileType

Identifies the file type property value. You use this name constant to set or obtain a value of type OSType that represents the file type as specified in a call to the function URLOpen. If the file type was not specified, kURLFileType obtains the file type compatible with the MIME type.

kURLFileCreator

Identifies the file creator property value. You use this name constant to set or obtain a value of type OSType that represents the file creator as specified in a call to the function URLOpen. If the file creator was not specified, kURLFileType obtains the file type compatible with the MIME type.

kURLCharacterSet

Identifies the character set property value. You use this name constant to obtain a Pascal string that represents the character set used by the URL, as returned by the HTTP server.

kURLResourceName

Identifies the resource name property value. You use this name constant to obtain a Pascal string that represents the name associated with the data to be downloaded.

kURLHost

Identifies the host property value. You use this name constant to obtain a Pascal string that represents the host on which the data is located.

kURLAuthType

Identifies the authentication type property value. You use this name constant to obtain a value that represents the type of authentication that the download operation requires. The default authentication type is kUserNameAndPasswordFlag , described in "Authentication Type Constant".

kURLUserName

Identifies the user name property value. You use this name constant to set or obtain a Pascal string that represents the user name used for authentication.

kURLPassword

Identifies the password property value. You use this name constant to set or obtain a Pascal string that represents the password used for authentication.

kURLStatusString

Identifies the status property value. You use this name constant to obtain a Pascal string that represents the current status of the data stream. You can use this property to display the status of the data transfer operation.

kURLIsSecure

Identifies the security property value. You use this name constant to get a Boolean value that indicates whether the download operation is secure.

kURLCertificate

Identifies the certificate property value. You use this name constant to obtain a buffer of data that represents the certificate provided by a remote server.

kURLTotalItems

Identifies the total items property value. You use this name constant to obtain a value of type UInt32 that represents the total number of items being uploaded or downloaded.

Discussion

These constants represent Apple-defined name constants that identify property values universal to all URLs. For a description of the name constants that identify property values specific to HTTP and HTTPS URLs, see HTTP and HTTPS URL Property Name Constants.

You pass one of these name constants in the property parameter of the functions URLSetProperty and URLGetProperty, respectively, to set or obtain a particular property value. Note that you can only set the universal property values identified by the constants kURLPassword and kURLUserName . You must also pass the correct data type corresponding to the property value in the propertyBuffer parameter of these functions.