combaseapi.h (FreePropVariantArray 函式)

FreePropVariantArray 函式會在 rgvars 陣列中的每個 PROPVARIANT 結構上呼叫 PropVariantClear，讓數位的每個成員的值為零。

語法

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

參數

[in] cVariants

PROPVARIANT 陣列中的元素計數 (rgvars) 。

[in] rgvars

要釋放任何可解除分配專案之 PROPVARIANT 結構的初始化數位指標。 結束時，所有零都會寫入 PROPVARIANT 結構， (因此將它們標記為VT_EMPTY) 。

傳回值

此函式會傳回 HRESULT。

備註

FreePropVariantArray 會在 PROPVARIANT 結構的陣列上呼叫 PropVariantClear，以清除所有有效的成員。 釋放所有有效的 PROPVARIANT 結構。 如果任何 PROPVARIANT 結構包含不合法的 VT 類型，則會釋放有效的成員，而且函式會傳回STG_E_INVALIDPARAMETER。

傳遞 rgvars 的 NULL 是合法的，併產生S_OK的傳回碼。

規格需求

另請參閱

PropVariantClear