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;
//
}