SetContainerACL Method
Sets the stored access policies and public access level for a container.
Syntax
int SetContainerACL(int iPublicAccess);
Remarks
This method sets the stored access policies and the public access level for the container currently specified by Container. The items in the AccessPolicy* properties determine the new set of stored access policies, and PublicAccess determines the new public access level. Possible values are:
acpaNone (0) | The container is private. |
acpaBlobs (1) | Blob data within the container is publicly readable, but blobs cannot be listed. |
acpaContainer (2) | Container information and blob data within the container is publicly readable, and blobs can be listed. |
Note that it is not possible to do a partial update of stored access policies. That is, all stored access policies currently associated with the container will be replaced with the stored access policies sent in the request. To prevent data loss, applications should call GetContainerACL to retrieve the container's current stored access polices, and then add/modify/remove them as desired, before using this method.
If the specified container has an active lease, a lease Id may optionally be specified using LeaseId; the request will only succeed if the correct lease Id is specified.
Error Handling
This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)