POPEN_ROUTINE回呼函式 (resapi.h)

開啟 資源。 POPEN_ROUTINE類型會定義此函式的指標。

語法

POPEN_ROUTINE PopenRoutine;

RESID PopenRoutine(
  [in] LPCWSTR ResourceName,
  [in] HKEY ResourceKey,
  [in] RESOURCE_HANDLE ResourceHandle
)
{...}

參數

[in] ResourceName

要開啟的資源名稱。

[in] ResourceKey

叢集的資料庫索引鍵，其中包含ResourceName所代表的資源。

[in] ResourceHandle

要傳遞至Startup進入點函式中SetResourceStatus回呼函式的控制碼。

傳回值

如果作業成功， Open 會傳回 (RESID) 的資源識別碼。

如果作業未成功， Open 會傳回 Null。 呼叫 SetLastError 以指定發生錯誤。

備註

Open進入點函式會以ResourceName參數所識別的名稱開啟資源，並傳回其資源識別碼。 資源識別碼可用於未來對其他 資源 API 進入點的呼叫，以識別資源。

請勿關閉ResourceHandle參數所代表的控制碼，或將其用於透過LogEvent回呼函式或SetResourceStatus回呼函式傳遞至資源監視器以外的任何用途。

如需 Open 進入點函式的有效實作策略，請參閱 實作 Open。

範例

請參閱 資源 DLL 範例。

需求

另請參閱

LogEvent

資源 DLL Entry-Point 函式

SetResourceStatus