SafeArrayAllocDescriptor 函式 (oleauto.h)

發行項
03/05/2024

配置安全陣列描述元的記憶體。

語法

HRESULT SafeArrayAllocDescriptor(
  [in]  UINT      cDims,
  [out] SAFEARRAY **ppsaOut
);

參數

[in] cDims

陣列維度的數目。

[out] ppsaOut

安全陣列描述元。

傳回值

此函式可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
E_INVALIDARG	自變數是無效的。
E_UNEXPECTED	陣列無法鎖定。

備註

此函式允許建立安全陣列，其中包含具有 SafeArrayCreate 所提供之數據類型以外的專案。使用 SafeArrayAllocDescriptor 建立陣列描述元之後，請在數位描述元中設定元素大小，呼叫 SafeArrayAllocData 以配置數位元素的記憶體。

範例

下列範例會使用 SafeArrayAllocDescriptor 和 SafeArrayAllocData 函式來建立安全數位。

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