コールバック関数PSTARTUP_ROUTINE (resapi.h)

関数テーブルとバージョン番号を含む構造体を返して、 リソース DLL を読み込みます。 PSTARTUP_ROUTINE型は、この関数へのポインターを定義します。

構文

PSTARTUP_ROUTINE PstartupRoutine;

DWORD PstartupRoutine(
  [in]  LPCWSTR ResourceType,
  [in]  DWORD MinVersionSupported,
  [in]  DWORD MaxVersionSupported,
  [in]  PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
  [in]  PLOG_EVENT_ROUTINE LogEvent,
  [out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}

パラメーター

[in] ResourceType

開始するリソースの種類。

[in] MinVersionSupported

クラスター サービスでサポートされているリソース API の最小バージョン。

[in] MaxVersionSupported

クラスター サービスでサポートされているリソース API の最大バージョン。

[in] SetResourceStatus

リソース DLL がオンラインまたはオフラインからERROR_IO_PENDINGを返した後に状態を更新するために呼び出すコールバック関数へのポインター。 詳細については、「 SetResourceStatus」を参照してください。

[in] LogEvent

リソース DLL がリソースのレポート イベントを呼び出すコールバック関数へのポインター。 詳細については、「 LogEvent」を参照してください。

[out] FunctionTable

Resource API のバージョンとエントリ ポイントの特定の名前を記述する CLRES_FUNCTION_TABLE 構造体へのポインター。

戻り値

リターン コード/値	Description
ERROR_SUCCESS 0	要求は成功しました。
ERROR_REVISION_MISMATCH 1306 (0x51A)	リソース DLL では、 MinVersionSupported パラメーターと MaxVersionSupported パラメーターによって識別される範囲内にあるバージョン は サポートされていません。

 

操作が成功しなかった場合、 Startup は システム エラー コードのいずれかを返す必要があります。

解説

スタートアップ エントリ ポイント関数は、Resource API のサポートされているインターフェイス バージョンと、サポートされているバージョンの Resource API で必要な他のすべての関数のエントリ ポイントの両方を記述する関数テーブルを返します。

現時点では、Resource API バージョン 1.0 のみがサポートされています。

リソースで複数のバージョンの Resource API がサポートされている場合は、最新バージョンの関数テーブルを返します。 バージョン番号は 、MaxVersionSupported パラメーター以下にする必要があります。 FunctionTable パラメーターが指す関数テーブルのバージョンが範囲内にない場合、リソースを正常に読み込むことができません。

詳細については、「 スタートアップの実装」を参照してください。

例

「スタートアップの実装」を参照してください。

要件

サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム	Windows
ヘッダー	resapi.h

関連項目

リソース DLL Entry-Point 関数