ホーム › Networking.Clustering › PCLUSAPI_GET_CLUSTER_NOTIFY_V2

PCLUSAPI_GET_CLUSTER_NOTIFY_V2

コールバック

シグネチャ

DWORD PCLUSAPI_GET_CLUSTER_NOTIFY_V2(
    HCHANGE hChange,
    UINT_PTR* lpdwNotifyKey,
    NOTIFY_FILTER_AND_TYPE* pFilterAndType,
    BYTE* buffer,
    DWORD* lpcchBufferSize,
    LPWSTR lpszObjectId,
    DWORD* lpcchObjectId,
    LPWSTR lpszParentId,
    DWORD* lpcchParentId,
    LPWSTR lpszName,
    DWORD* lpcchName,
    LPWSTR lpszType,
    DWORD* lpcchType,
    DWORD dwMilliseconds
);

パラメーター

フィールド	型	説明
hChange	HCHANGE	通知ポートのハンドルです。このハンドルは CreateClusterNotifyPortV2 関数によって作成されます。
lpdwNotifyKey	UINT_PTR*	通知ポートの通知キーへのポインターです。
pFilterAndType	NOTIFY_FILTER_AND_TYPE*	通知ポートの次の通知イベントを記述する NOTIFY_FILTER_AND_TYPE 構造体へのポインターです。
buffer	BYTE*	通知イベントを受け取るバッファーへのポインターです。
lpcchBufferSize	DWORD*
lpszObjectId	LPWSTR	イベントを発生させたクラスターオブジェクトの ID を格納する Unicode 文字列へのポインターです。文字列は終端の null 文字で終わります。
lpcchObjectId	DWORD*	入力時は、終端の null 文字を含めて lpszObjectId パラメーターが保持できる最大文字数を指定する DWORD へのポインターです。出力時は、終端の null 文字を除いて lpszObjectId が受け取った文字数を示す DWORD へのポインターです。
lpszParentId	LPWSTR	イベントを発生させたクラスターオブジェクトの親の ID を格納する Unicode 文字列へのポインターです。文字列は終端の null 文字で終わります。
lpcchParentId	DWORD*	入力時は、終端の null 文字を含めて lpszParentId パラメーターが保持できる最大文字数を指定する DWORD へのポインターです。出力時は、終端の null 文字を除いて lpszParentId が受け取った文字数を示す DWORD へのポインターです。
lpszName	LPWSTR	イベントを発生させたクラスターオブジェクトの名前を格納する Unicode 文字列へのポインターです。文字列は終端の null 文字で終わります。
lpcchName	DWORD*	入力時は、終端の null 文字を含めて lpszName パラメーターが保持できる最大文字数を指定する DWORD へのポインターです。出力時は、終端の null 文字を除いて lpszName が受け取った文字数を示す DWORD へのポインターです。
lpszType	LPWSTR	イベントを発生させたクラスターオブジェクトの種類を格納する Unicode 文字列へのポインターです。文字列は終端の null 文字で終わります。
lpcchType	DWORD*	入力時は、終端の null 文字を含めて lpszType パラメーターが保持できる最大文字数を指定する DWORD へのポインターです。出力時は、終端の null 文字を除いて lpszType が受け取った文字数を示す DWORD へのポインターです。
dwMilliseconds	DWORD	呼び出し元が通知をどれだけ待機するかを指定するタイムアウト値です。

公式ドキュメント

通知ポートの次の通知イベントに関する情報を取得します。

戻り値

操作が成功した場合、この関数は ERROR_SUCCESS を返します。

操作が失敗した場合、この関数は次のいずれかのシステムエラーコードを返します。

戻り値/値	説明
ERROR_INVALID_HANDLE 6	hChange パラメーターで表されるハンドルが無効であるか、別のスレッドによって閉じられています。
WAIT_TIMEOUT 258 (0x102)	通知が正常に返される前に、呼び出しがタイムアウトしました。
ERROR_MORE_DATA 234 (0xEA)	lpszName パラメーターが指すバッファーは、結果を格納するのに十分な大きさではありません。lpcchName パラメーターは、終端の null 文字を除いた結果の文字数を返します。

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