IHolder：：AllocResource 方法 (comsvcs.h)

  • 發行項

從清查配置資源。

語法

HRESULT AllocResource(
  [in]  const RESTYPID __MIDL__IHolder0000,
  [out] RESID          *__MIDL__IHolder0001
);

參數

[in] __MIDL__IHolder0000

要配置的資源類型。

[out] __MIDL__IHolder0001

傳回已配置資源控制碼的位置指標。

傳回值

這個方法可以傳回下列值。

傳回碼 描述
S_OK
 已成功完成命令。
E_INVALIDARG
 ResTypId 是 Null 或空字串，或是 Resource Dispenser 的 IDispenserDriver：：CreateResource 方法會產生空的或重複的 RESID。
E_FAIL
方法失敗。 尚未設定 pResId 參數。 可能的原因是呼叫端的交易已中止。

備註

分配器管理員會採取下列步驟來尋找資源：

  1. 在集區中搜尋此 RESTYPID 的免費資源，此資源已在呼叫端的目前交易中登記。
  2. 在集區中搜尋此 RESTYPID 的免費未列出的資源，然後將它編列在呼叫端的目前交易中。
  3. 呼叫資源配置器的 IDispenserDriver：：CreateResource 方法，然後編列資源，以建立資源。
如果呼叫端沒有目前的交易，則會略過登記。 或者，如果資源配置器拒絕登記 (表示資源無法交易) ，則會略過登記。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 comsvcs.h

另請參閱

IDispenserDriver

IDispenserManager

IHolder