ClearPropVariantArray 函式 (propvarutil.h)

釋放儲存在陣列中 之 PROPVARIANT 結構的陣列所使用的記憶體和參考。

語法

PSSTDAPI_(void) ClearPropVariantArray(
  [in] PROPVARIANT *rgPropVar,
  [in] UINT        cVars
);

參數

[in] rgPropVar

類型： PROPVARIANT*

要釋放的 PROPVARIANT 結構數位。

[in] cVars

類型： UINT

rgPropVar 所指定陣列中的項目數目。

傳回值

沒有傳回值。

備註

此函式會釋放數位中每個結構所持有的記憶體和參考，再將結構設定為零。

此函式會執行與 FreePropVariantArray相同的動作，但 FreePropVariantArray 會傳回 HRESULT。

範例

下列範例要包含在較大的程式中，示範如何使用 ClearPropVariantArray

// PROPVARIANT rgpropvar[5];
// Assume all 5 propvariants are initialized and valid.

ClearPropVariantArray(rgpropvar, ARRAYSIZE(rgpropvar));

規格需求

另請參閱

ClearVariantArray