Share via


SafeArrayUnlock 函式 (oleauto.h)

遞減數位的鎖定計數,以便釋放或重設大小。

語法

HRESULT SafeArrayUnlock(
  [in] SAFEARRAY *psa
);

參數

[in] psa

SafeArrayCreate 所建立的陣列描述元。

傳回值

此函式可以傳回其中一個值。

傳回碼 描述
S_OK
成功。
E_INVALIDARG
自變數 無效的。
E_UNEXPECTED
無法解除鎖定陣列。

備註

在陣列中的數據存取完成之後,會呼叫此函式。

執行緒安全性

SAFEARRAY 數據類型的所有公用靜態成員都是安全線程。 實例成員不保證為安全線程。

例如,請考慮使用 SafeArrayLock 和 SafeArrayUnlock 函式的應用程式。 如果從相同 SAFEARRAY 數據類型 實例上的不同線程同時呼叫這些函式,可能會建立不一致的鎖定計數。 這最終會導致 SafeArrayUnlock 函式傳回E_UNEXPECTED。 您可以藉由提供自己的同步程式代碼來防止這種情況。

規格需求

需求
目標平台 Windows
標頭 oleauto.h
程式庫 OleAut32.lib
Dll OleAut32.dll