获取对象属性

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本文介绍获取对象属性值。

接口定义：

void S3_head_object(const S3BucketContext *bucketContext, const char *key,
                    S3RequestContext *requestContext,
                    int timeoutMs,
                    const S3ResponseHandler *handler, void *callbackData);

参数：

参数名	类型	说明
bucketContext	const S3BucketContext *	包含bucket及相关的请求参数
key	const char *	要获取属性的对象名称
requestContext	S3RequestContext *	请求参数，如果为NULL，则立即同步执行请求
timeoutMs	int	如果非0，则是以毫秒为单位的请求超时时间
handler	const S3ResponseHandler *	回调函数
callbackData	void *	回调数据

代码示例：

#include <unistd.h>

void head_object(const char *bucketName, const char *key)
{
    S3BucketContext bucketContext =
        {
            hostname,
            bucketName,
            protocolG,
            uriStyleG,
            accessKeyG,
            secretKeyG};

    S3ResponseHandler responseHandler =
        {
            &responsePropertiesCallback,//在此回调函数中编写相应的代码以获取您所需要的属性
            &responseCompleteCallback};

    do
    {
        S3_head_object(&bucketContext, key, 0, 0, &responseHandler, 0);
    } while (S3_status_is_retryable(statusG) && should_retry());

    if ((statusG != S3StatusOK) &&
        (statusG != S3StatusErrorPreconditionFailed))
    {
        printError();
    }
}