SafeArrayLock
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função Incrementa a contagem bloqueio de uma matriz e coloca um ponteiro para os dados na matriz pvData do descritor de matriz.
Syntax
HRESULT SafeArrayLock(
SAFEARRAY FAR* psa
);
Parameters
- psa
[in, Out] Ponteiro para uma descritor de matriz criado por SafeArrayCreate.
Return Value
Retorna os valores HRESULT mostrados a seguinte tabela.
| Valor | Descrição |
|---|---|
S_OK |
O sucesso. |
E_INVALIDARG |
O psa parâmetro não era um válido SafeArray descritor. |
E_UNEXPECTED |
A matriz não pôde ser bloqueado. |
Remarks
O ponteiro no descritor de matriz é válido até SafeArrayUnlock é chamado.
Chamadas para SafeArrayLock podem ser aninhados. Um número igual de chamadas para SafeArrayUnlock São exigido.
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
Uma matriz não pode ser excluído enquanto ele está bloqueado.
Requirements
| Header | oleauto.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |