ILockBytes：：LockRegion 方法 (objidl.h)

發行項
02/29/2024

LockRegion 方法會限制對位元組陣列中指定位元組範圍的存取。

語法

HRESULT LockRegion(
  [in] ULARGE_INTEGER libOffset,
  [in] ULARGE_INTEGER cb,
  [in] DWORD          dwLockType
);

參數

[in] libOffset

指定範圍開頭的位元組位移。

[in] cb

以位元組為單位，指定要限制的範圍長度。

[in] dwLockType

指定存取範圍時所要求的限制類型。此參數使用 LOCKTYPE 列舉的其中一個值。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	指定的位元組範圍已鎖定。
STG_E_INVALIDFUNCTION	完全不支援鎖定，或不支援所要求的特定鎖定類型。
STG_E_ACCESSDENIED	因為呼叫端的許可權不足，或另一個呼叫端開啟並鎖定檔案，所以拒絕存取。
STG_E_LOCKVIOLATION	因為另一個呼叫端已開啟並鎖定檔案，所以拒絕存取。
STG_E_INVALIDHANDLE	基礎檔案已提前關閉，或正確的磁碟片已被無效的磁碟取代。

備註

ILockBytes：：LockRegion 會限制對指定位元組範圍的存取。鎖定區域之後，其他人嘗試取得限制範圍的存取權必須失敗，並出現STG_E_ACCESSDENIED錯誤。

位元組範圍可以延伸超過位元組陣組的目前結尾。超出陣列結尾的鎖定，有助於做為位元組陣組物件不同實例之間通訊的方法，而不需要變更實際屬於位元組陣列的數據。例如，複合檔案的 ILockBytes 實作可能依賴鎖定超過數位目前結尾的鎖定作為訪問控制的方法，使用特定的鎖定區域來指出目前授與的許可權。

dwLockType 參數會使用LOCKTYPE列舉中的值，指定三種鎖定類型的其中一種。這些類型如下所示：鎖定以排除其他寫入器、鎖定以排除其他讀取器或寫入器，以及只允許一個要求者取得指定範圍鎖定的鎖定。第三種類型的鎖定通常是其他兩種鎖定類型之一的別名，並允許實作者新增其他行為。指定的位元組陣列可能支援前兩個類型之一，或兩者皆支援。

若要判斷特定 ILockBytes 實作所支援的鎖定類型，您可以檢查呼叫 ILockBytes：：Stat 所傳回之 STATSTG 結構的 grfLocksSupported 成員。

使用 ILockBytes：：LockRegion 鎖定的任何區域之後，都必須呼叫與 libOffset、cb 和 dwLockType 參數完全相同的 ILockBytes：：UnlockRegion 來明確解除鎖定。必須先解除鎖定區域，才能釋放數據流。無法個別鎖定兩個相鄰區域，然後使用單一解除鎖定呼叫解除鎖定。

來電者附註

由於支持的鎖定類型是選擇性的，而且在 ILockBytes 的不同實作中可能會有所不同，因此您必須提供程式碼來處理STG_E_INVALIDFUNCTION錯誤。

實作者的注意事項

此方法的支持取決於使用 ILockBytes 實作之上建置的儲存物件方式。如果您知道在任何指定時間只能開啟一個儲存物件，且該儲存裝置在位元組陣列之下，則 您的ILockBytes 實作不需要支持鎖定。不過，如果可以同時開啟記憶體物件，則需要區域鎖定來協調它們。

LockRegion 實作可以選擇支援所有、部分或無鎖定類型。對於不支持的鎖定類型，實作應該會傳回STG_E_INVALIDFUNCTION。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	objidl.h
程式庫	Uuid.lib
Dll	Ole32.dll