コールバック関数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 |
---|---|
|
要求は成功しました。 |
|
リソース 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 |