SafeArrayUnlockSafeArrayUnAccessData
f90VB Modules
f90VBDefs, f90VBSafeArrays
Summary
Invalidates a Fortran array mapping created with SafeArrayAccessData and decreases the lock counter of the Safe Array.
Syntax
| subroutine SafeArrayUnAccessData | (SARef,iRet) |
| { | |
| integer(SAFEARRAY_KIND),intent(in):: | SARef | |
| type(FSafeArray),intent(in):: | SARef | |
| } | |
| integer(HRESULT_KIND),intent(out),optional:: | iRet |
Arguments
SARef [Input]
A handle to, or a Fortran Safe Array structure containing a handle to, an allocated Safe Array descriptor.
iRet [Output, Optional]
Upon return, iRet contains S_OK or an error code. See comments for more information.
Comments
Note that SARef must be a reference to an allocated Safe Array.
A call to SafeArrayAccessData puts a lock on the passed Safe Array, until SafeArrayUnAccessData is called.
See comments for SafeArrayAccessData.
Argument iRet
Indicates success or failure of the subroutine. The following codes can be returned in this argument:
| Value returned in argument iRet | Description | |
| S_OK | Success. | |
| E_UNEXPECTED | The array could not be unlocked. | |
| E_INVALIDARG | The item pointed to by SARef is not a Safe Array descriptor | |
Examples
See example for SafeArrayCreate, SafeArrayLock, SafeArrayGetDim, Example 2.5 (User Manual - Chapter 2), Example 4.4 (User Manual - Chapter 4).
Related Topics
| For information about | See | |
| Obtaining the value of a Safe Array element | SafeArrayGetElement | |
| Changing the value of a Safe Array element | SafeArrayPutElement | |
| Locking/Unlocking a Safe Array | SafeArrayLock, SafeArrayUnlock | |
| Obtaining the lock-counter of a Safe Array | SafeArrayGetLocks | |
| Allocating a Safe Array descriptor | SafeArrayAllocDescriptor | |