共用方式為

SafeArrayAllocDescriptor 函式 (oleauto.h)

  • 發行項

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

語法

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

規格需求

需求 值
目標平台 Windows
標頭 oleauto.h
程式庫 OleAut32.lib
Dll OleAut32.dll

另請參閱

SafeArrayAllocData

SafeArrayDestroyData

SafeArrayDestroyDescriptor