SafeArrayGetUBound

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Gibt die Obergrenze für jede Dimension ein sicheres Array zurück.

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

Parameter

  • psa
    Zeiger auf ein Arraydeskriptor SafeArrayCreate erstellt.

  • nDim
    Die Array-Dimension, für die die obere Grenze abgerufen werden soll.

  • plUbound
    Zeiger auf den Speicherort der oberen Grenze zurückgegeben.

Rückgabewert

Der Rückgabewert vom zurückgegebenen HRESULT ist eine der folgenden.

Rückgabewert

Bedeutung

S_OK

Erfolg.

DISP_E_BADINDEX

Der angegebene Index ist außerhalb des gültigen Bereichs.

E_INVALIDARG

Eines der Argumente ist ungültig.

Beispiel

HRESULT
CEnumPoint::Create(SAFEARRAY * psa, CEnumPoint ** ppenum)
{
   long uBound;
   HRESULT hresult;

   // Verify that the SafeArray is the proper shape.
   hresult = SafeArrayGetUBound(psa, 1, &uBound);
   if(FAILED(hresult))
      return hresult;

   // 

}