SafeArrayAllocData
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Reserviert Speicher für ein sicheres Array basierend auf einen Deskriptor mit SafeArrayAllocDescriptor erstellt.
HRESULT SafeArrayAllocData(
SAFEARRAY *psa
);
Parameter
- psa
Zeiger auf ein Arraydeskriptor SafeArrayAllocDescriptor erstellt.
Rückgabewert
Der Rückgabewert vom zurückgegebenen HRESULT ist eine der folgenden.
Rückgabewert |
Bedeutung |
---|---|
S_OK |
Erfolg. |
E_INVALIDARG |
Das Argument psa konnte keinen Deskriptor mit gültigen sicheres Array. |
E_UNEXPECTED |
Das Array konnte nicht gesperrt werden. |
Beispiel
Im folgenden Beispiel wird ein sicheres Array mithilfe der SafeArrayAllocDescriptor und SafeArrayAllocData Funktionen erstellt.
SAFEARRAY *psa;
unsigned int ndim = 2;
HRESULT hresult = SafeArrayAllocDescriptor(ndim, &psa);
if( FAILED(hresult))
return ERR_OutOfMemory;
(psa)->rgsabound[ 0 ].lLbound = 0;
(psa)->rgsabound[ 0 ].cElements = 5;
(psa)->rgsabound[ 1 ].lLbound = 1;
(psa)->rgsabound[ 1 ].cElements = 4;
hresult = SafeArrayAllocData(psa);
if( FAILED(hresult)) {
SafeArrayDestroyDescriptor(psa);
return ERR_OutOfMemory;
}