SafeArrayUnlock, fonction (oleauto.h)

Article
03/01/2024

Décrémente le nombre de verrous d’un tableau afin qu’il puisse être libéré ou redimensionné.

Syntaxe

HRESULT SafeArrayUnlock(
  [in] SAFEARRAY *psa
);

Paramètres

[in] psa

Descripteur de tableau créé par SafeArrayCreate.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	L’argument psa n’est pas valide.
E_UNEXPECTED	Impossible de déverrouiller le tableau.

Remarques

Cette fonction est appelée une fois l’accès aux données d’un tableau terminé.

Cohérence de thread

Tous les membres statiques publics du type de données SAFEARRAY sont thread-safe. Il n’est pas garanti que les membres de l’instance soient thread-safe.

Prenons l’exemple d’une application qui utilise les fonctions SafeArrayLock et SafeArrayUnlock. Si ces fonctions sont appelées simultanément à partir de threads différents sur le même type de données SAFEARRAY instance, un nombre de verrous incohérent peut être créé. La fonction SafeArrayUnlock retourne alors E_UNEXPECTED. Vous pouvez éviter cela en fournissant votre propre code de synchronisation.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	oleauto.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll

Share via