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

[アーティクル]
08/25/2023

クリーンアップ処理が完了した後、リソースを使用不可としてマークします。 POFFLINE_V2_ROUTINE型は、この関数へのポインターを定義します。

構文

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

パラメーター

[in] Resource

オフラインにするリソースのリソース識別子。

[in, optional] DestinationNodeName

操作の完了時にリソースを格納するノードの名前。

[in] OfflineFlags

この操作の設定を指定するフラグのビットマスク。このパラメーターは、次の 1 つ以上の値に設定できます。

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

リソースがロックする必要があることを示している場合でも、操作を実行します。

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

リソースでエラーが発生した場合は、ソースノードに返します。

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

リソース DLL によって遅延が発生した場合は操作をキューに入れ、操作が完了するかクライアントによって取り消されるまで再試行します。

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

リソースでエラーが発生し、ソースノードに戻っていることを示します。

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

埋め込みエラーが発生したことを示します。

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

ネットワークエラーが発生した場合でも、操作を実行します。

Windows Server 2012: この値は、R2 をWindows Server 2012する前にサポートされていません。

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

リソースの永続的な状態を更新しないでください。

Windows Server 2012 R2 と Windows Server 2012: この値は、Windows Server 2016する前にサポートされていません。

[in, optional] InBuffer

操作のデータを含むバッファーへのポインター。それ以外の場合、操作にデータが必要ない場合は NULL 。

[in] InBufferSize

InBuffer パラメーターのサイズ (バイト単位)。

[in] Reserved

予約済み。

戻り値

リターンコード/値	Description
ERROR_SUCCESS 0	要求が正常に完了し、リソースがオフラインです。
ERROR_IO_PENDING 997 (0x3E5)	要求はまだ保留中であり、オフライン要求を処理するためにスレッドがアクティブ化されています。

他の理由で操作が成功しなかった場合、この関数はシステムエラーコードの 1 つを返します。

要件

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

こちらもご覧ください

リソース DLL エントリポイント関数

次の方法で共有