IPerPropertyBrowsing：：GetPredefinedStrings 方法 (ocidl.h)

擷取指定屬性可接受之允許值的陣列描述字串。

語法

HRESULT GetPredefinedStrings(
  [in]  DISPID     dispID,
  [out] CALPOLESTR *pCaStringsOut,
  [out] CADWORD    *pCaCookiesOut
);

參數

[in] dispID

屬性的分派標識碼。

[out] pCaStringsOut

呼叫端配置的已計算數位結構的指標，其中包含字串指標之方法配置陣列的專案計數和位址。 這個方法也會為包含預先定義名稱的字串值配置記憶體，並將字元串指標儲存在數位中。 如果方法失敗，則不會配置記憶體，而且未定義結構的內容。

[out] pCaCookiesOut

呼叫端配置的計數陣列結構的指標，其中包含 DWORD 值之方法配置陣列的專案計數和位址。 陣列中的值可以傳遞至 IPerPropertyBrowsing：：GetPredefinedValue ，以擷取 與 pCaStringsOut 內相同數位位置中名稱相關聯的值。 如果方法失敗，則不會配置記憶體，而且未定義結構的內容。

傳回值

這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

備註

pCaStringsOut 所指向數位中的每個字串在 pCaCookiesOut 所指向的計數陣列中有相符的標記，其中令牌可以傳遞至 IPerPropertyBrowsing：：GetPredefinedValue，以取得與字串相對應的 VARIANT) (實際值。

使用預先定義的字串，呼叫者可以取得用來填入使用者介面元素的字串清單，例如下拉式清單框。 當用戶選取其中一個字串作為要指派給屬性的值時，呼叫端就可以透過 IPerPropertyBrowsing：：GetPredefinedValue 取得對應的值。

來電者附註

所有記憶體都以 CoTaskMemAlloc 配置。 呼叫端負責使用 CoTaskMemFree 釋放字串和陣列。

從這個方法傳回時，呼叫端會負責所有這個記憶體，而且當不再需要時必須釋放它。 要達成此目的的程式代碼如下所示。

CALPOLESTR     castr; 
CWDWORD        cadw; 
ULONG          i; 
 
pIPerPropertyBrowsing->GetPredefinedStrings(dispID, &castr, &cadw); 
 
//...Use the strings and the cookies 
 
CoTaskMemFree((void *)cadw.pElems); 
 
for (i=0; i < castr.cElems; i++) 
    CoTaskMemFree((void *)castr.pElems[i]); 
 
CoTaskMemFree((void *)castr.pElems); 

實作者的注意事項

這個方法會填滿 CADWORD 和 CALPOLESTR 結構的 cElems 和 pElems 成員。 它會使用 CoTaskMemAlloc 配置這些結構所指向的數位，並填滿這些數位。 在 CALPOLESTR 案例中，此方法也會使用 CoTaskMemAlloc 配置每個字串，並將每個字串指標儲存在數位中。

規格需求

另請參閱

CADWORD

CALPOLESTR

IPerPropertyBrowsing