SafeArrayPtrOfIndex
9/8/2008
Essa função recupera um ponteiro para um elemento matriz.
Syntax
HRESULT SafeArrayPtrOfIndex(
SAFEARRAY FAR* psa,
long FAR* rgIndices,
void HUGEP* FAR* ppvData
);
Parameters
- psa
Ponteiro para uma descritor de matriz criado por SafeArrayCreate.
- rgIndices
Matriz de valores índice que identifica um elemento da matriz. Todos os índices para o elemento devem ser especificados.
- ppvData
Em retorno, ponteiro para void o ponteiro para o elemento identificado pelos valores em rgIndices.
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. |
DISP_E_BADINDEX |
O índice especificado era inválido. |
Remarks
A matriz deve ser bloqueada antes SafeArrayPtrOfIndex é chamado. Falhando ao bloqueio de matriz pode causar resultados imprevisíveis.
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
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 |
See Also
Reference
Automation Functions
SafeArrayCreate
SafeArrayUnlock
SafeArrayLock