共用方式為

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的傳回碼。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 combaseapi.h
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

PropVariantClear