Compartilhar via


SafeArrayGetUBound

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função recupera o limite superior para qualquer dimensão de um SafeArray.

Syntax

HRESULT SafeArrayGetUBound(
  SAFEARRAY FAR* psa, 
  unsigned int nDim, 
  long FAR* plUbound 
);

Parameters

  • psa
    [no] Ponteiro para uma descritor de matriz criado por SafeArrayCreate.
  • nDim
    [no] Especifica a dimensão matriz para get o limite superior para.
  • plUbound
    [out] Ponteiro para a localidade para retornar a limite superior.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Valor Descrição

S_OK

O sucesso.

DISP_E_BADINDEX

O índice especificado está fora dos limites.

E_INVALIDARG

Um argumento é inválido.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Example

HRESULT
CEnumPoint::Create(SAFEARRAY FAR* psa, CEnumPoint FAR* FAR* ppenum)
{
  long lBound;
  HRESULT hresult;
  CEnumPoint FAR* penum;
  // Verify that the SafeArray is the proper shape.
  HRESULT = SafeArrayGetUBound(psa, 1, &lBound);
  if(FAILED(hresult))
    goto LError0;
  // Code omitted here for brevity.
LError0:;
  penum->Release();
  return hresult;
}

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