次の方法で共有


SafeArrayGetUBound (Compact 2013)

3/26/2014

This function retrieves the upper bound for any dimension of a safearray.

Syntax

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

Parameters

  • nDim
    [in] Specifies the array dimension to get the upper bound for.
  • plUbound
    [out] Pointer to the location to return the upper bound.

Return Value

Returns the HRESULT values shown in the following table.

Value

Description

S_OK

Success.

DISP_E_BADINDEX

The specified index is out of bounds.

E_INVALIDARG

An argument is invalid.

Remarks

Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.

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

See Also

Reference

Automation Functions
SafeArrayCreate