Compartilhar via


Função SafeArrayUnlock (oleauto.h)

Decrementa a contagem de bloqueios de uma matriz para que ela possa ser liberada ou redimensionada.

Sintaxe

HRESULT SafeArrayUnlock(
  [in] SAFEARRAY *psa
);

Parâmetros

[in] psa

Um descritor de matriz criado por SafeArrayCreate.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
O argumento psa não é válido.
E_UNEXPECTED
Não foi possível desbloquear a matriz.

Comentários

Essa função é chamada depois que o acesso aos dados em uma matriz é concluído.

Acesso thread-safe

Todos os membros estáticos públicos do tipo de dados SAFEARRAY são thread-safe. Não há garantia de que os membros da instância sejam thread-safe.

Por exemplo, considere um aplicativo que usa as funções SafeArrayLock e SafeArrayUnlock. Se essas funções forem chamadas simultaneamente de threads diferentes na mesma instância de tipo de dados SAFEARRAY , uma contagem de bloqueio inconsistente poderá ser criada. Isso eventualmente fará com que a função SafeArrayUnlock retorne E_UNEXPECTED. Você pode evitar isso fornecendo seu próprio código de sincronização.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll