ホーム › Networking.Clustering › PSTARTUP_ROUTINE

PSTARTUP_ROUTINE

コールバック

シグネチャ

DWORD PSTARTUP_ROUTINE(
    LPWSTR ResourceType,
    DWORD MinVersionSupported,
    DWORD MaxVersionSupported,
    PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
    PLOG_EVENT_ROUTINE LogEvent,
    CLRES_FUNCTION_TABLE** FunctionTable
);

パラメーター

フィールド	型	説明
ResourceType	LPWSTR	開始されるリソースの種類。
MinVersionSupported	DWORD	クラスターサービスがサポートする Resource API の最小バージョン。
MaxVersionSupported	DWORD	クラスターサービスがサポートする Resource API の最大バージョン。
SetResourceStatus	PSET_RESOURCE_STATUS_ROUTINE	Online または Offline から ERROR_IO_PENDING を返した後、リソース DLL が自身の状態を更新するために呼び出すコールバック関数へのポインター。詳細については SetResourceStatus を参照してください。
LogEvent	PLOG_EVENT_ROUTINE	リソース DLL がリソースのイベントを報告するために呼び出すコールバック関数へのポインター。詳細については LogEvent を参照してください。
FunctionTable	CLRES_FUNCTION_TABLE**	Resource API のバージョンと各エントリポイントの具体的な名前を記述する CLRES_FUNCTION_TABLE 構造体へのポインター。

公式ドキュメント

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

戻り値

リターンコード/値	説明
ERROR_SUCCESS 0	要求は成功しました。
ERROR_REVISION_MISMATCH 1306 (0x51A)	リソース DLL が、MinVersionSupported パラメーターと MaxVersionSupported パラメーターで示される範囲のバージョンをサポートしていません。

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

解説(Remarks)

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

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

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

詳細については Startup の実装を参照してください。

例

Startup の実装を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)