共用方式為

PropVariantToBooleanVectorAlloc 函式 (propvarutil.h)

  • 發行項

將資料從 PROPVARIANT 結構擷取至新配置的布林向量。

語法

PSSTDAPI PropVariantToBooleanVectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] BOOL           **pprgf,
  [out] ULONG          *pcElem
);

參數

[in] propvar

類型： REFPROPVARIANT

來源 PROPVARIANT 結構的參考。

[out] pprgf

類型： BOOL**

當此函式傳回時，會包含從來源 PROPVARIANT 結構擷取之布林值向量的指標。

[out] pcElem

類型： ULONG*

當此函式傳回時，包含從來源 PROPVARIANT 結構擷取的布林專案計數。

傳回值

類型： HRESULT

此函式可以傳回其中一個值。

傳回碼 描述
S_OK
 如果成功，則傳回 S_OK ，否則傳回錯誤值。
E_INVALIDARG
 PROPVARIANT不是適當的類型。

備註

這個協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留布林向量值的位置。

如果來源 PROPVARIANT 的類型為 VT_VECTOR |VT_BOOL或VT_ARRAY |VT_BOOL，此函式會將布林值的向量擷取到新配置的 BOOL 值向量。 呼叫的應用程式負責使用 CoTaskMemFree ，在不再需要 pprgf 時釋放 pprgf 所指向的向量。

範例

下列範例要包含在較大的程式中，示範如何使用 PropVariantToBooleanVectorAlloc 來存取 PROPVARIANT中的布林向量值。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is 
// expecting propvar to contain a vector of Boolean values.
BOOL *prgFlags;
ULONG cFlags;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgFlags, &cFlags);

if (SUCCEEDED(hr))
{
     // The prgFlags variable now points to a vector that contains a count
     // of cFlags flags.
     CoTaskMemFree(prgFlags);
}

需求

   
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 propvarutil.h
程式庫 Propsys.lib
Dll Propsys.dll (6.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0

另請參閱

InitPropVariantFromBooleanVector

IsPropVariantVector

PropVariantGetBooleanElem

PropVariantToBooleanVector