FreePropVariantArray 函式 (propidl.h)

釋放 PROPVARIANT 結構的數位所使用的記憶體和參考。

語法

HRESULT FreePropVariantArray(
  [in]      ULONG       cVariants,
  [in, out] PROPVARIANT *rgvars
);

參數

[in] cVariants

類型： ULONG

rgvars 所指定陣列中的元素數目。

[in, out] rgvars

類型： PROPVARIANT*

要釋放的 PROPVARIANT 結構數位。 當此函式成功傳回時，陣列中的 PROPVARIANT 結構會設為零，且其類型會設定為 VT_EMPTY。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式會在將結構設定為零之前，釋放陣列中每個結構所持有的記憶體和參考。

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

範例

下列範例會示範如何使用 FreePropVariantArray 作為較大程式的一部分

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

FreePropVariantArray(ARRAYSIZE(rgpropvar), rgpropvar);

規格需求