ホーム › Networking.Clustering › SetClusterGroupNodeList

SetClusterGroupNodeList

関数

クラスターグループの優先ノード一覧を設定する。

DLLCLUSAPI.dll呼出規約winapi対応OSwindowsserver2008

シグネチャ

// CLUSAPI.dll
#include <windows.h>

DWORD SetClusterGroupNodeList(
    HGROUP hGroup,
    DWORD NodeCount,
    HNODE* NodeList   // optional
);

パラメーター

名前	型	方向	説明
hGroup	HGROUP	in	ノードのリストを割り当てる対象のグループのハンドル。
NodeCount	DWORD	in	NodeList で指定されるリスト内のノードの数。
NodeList	HNODE*	inoptional	優先順に並べたノードのハンドルの配列。最初のノードが最も優先度が高く、最後のノードが最も優先度が低くなります。NodeList 配列内のノードの数は NodeCount パラメーターで制御されます。

戻り値の型: DWORD

公式ドキュメント

グループの優先ノードリストを設定します。

戻り値

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

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

解説(Remarks)

リソース DLL から SetClusterGroupNodeList を呼び出さないでください。詳細については、Function Calls to Avoid in Resource DLLs を参照してください。

LPC ハンドルと RPC ハンドルを同じ関数呼び出しに渡さないでください。渡した場合、その呼び出しは RPC 例外を発生させ、さらに破壊的な影響を及ぼす可能性があります。LPC ハンドルと RPC ハンドルの作成方法については、Using Object Handles および OpenCluster を参照してください。

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

各言語での呼び出し定義

// CLUSAPI.dll
#include <windows.h>

DWORD SetClusterGroupNodeList(
    HGROUP hGroup,
    DWORD NodeCount,
    HNODE* NodeList   // optional
);

[DllImport("CLUSAPI.dll", ExactSpelling = true)]
static extern uint SetClusterGroupNodeList(
    IntPtr hGroup,   // HGROUP
    uint NodeCount,   // DWORD
    IntPtr NodeList   // HNODE* optional
);

<DllImport("CLUSAPI.dll", ExactSpelling:=True)>
Public Shared Function SetClusterGroupNodeList(
    hGroup As IntPtr,   ' HGROUP
    NodeCount As UInteger,   ' DWORD
    NodeList As IntPtr   ' HNODE* optional
) As UInteger
End Function

' hGroup : HGROUP
' NodeCount : DWORD
' NodeList : HNODE* optional
Declare PtrSafe Function SetClusterGroupNodeList Lib "clusapi" ( _
    ByVal hGroup As LongPtr, _
    ByVal NodeCount As Long, _
    ByVal NodeList As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

SetClusterGroupNodeList = ctypes.windll.clusapi.SetClusterGroupNodeList
SetClusterGroupNodeList.restype = wintypes.DWORD
SetClusterGroupNodeList.argtypes = [
    ctypes.c_ssize_t,  # hGroup : HGROUP
    wintypes.DWORD,  # NodeCount : DWORD
    ctypes.c_void_p,  # NodeList : HNODE* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CLUSAPI.dll')
SetClusterGroupNodeList = Fiddle::Function.new(
  lib['SetClusterGroupNodeList'],
  [
    Fiddle::TYPE_INTPTR_T,  # hGroup : HGROUP
    -Fiddle::TYPE_INT,  # NodeCount : DWORD
    Fiddle::TYPE_VOIDP,  # NodeList : HNODE* optional
  ],
  -Fiddle::TYPE_INT)

#[link(name = "clusapi")]
extern "system" {
    fn SetClusterGroupNodeList(
        hGroup: isize,  // HGROUP
        NodeCount: u32,  // DWORD
        NodeList: *mut isize  // HNODE* optional
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("CLUSAPI.dll")]
public static extern uint SetClusterGroupNodeList(IntPtr hGroup, uint NodeCount, IntPtr NodeList);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CLUSAPI_SetClusterGroupNodeList' -Namespace Win32 -PassThru
# $api::SetClusterGroupNodeList(hGroup, NodeCount, NodeList)

#uselib "CLUSAPI.dll"
#func global SetClusterGroupNodeList "SetClusterGroupNodeList" sptr, sptr, sptr
; SetClusterGroupNodeList hGroup, NodeCount, varptr(NodeList)   ; 戻り値は stat
; hGroup : HGROUP -> "sptr"
; NodeCount : DWORD -> "sptr"
; NodeList : HNODE* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "CLUSAPI.dll"
#cfunc global SetClusterGroupNodeList "SetClusterGroupNodeList" sptr, int, var
; res = SetClusterGroupNodeList(hGroup, NodeCount, NodeList)
; hGroup : HGROUP -> "sptr"
; NodeCount : DWORD -> "int"
; NodeList : HNODE* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CLUSAPI.dll"
#cfunc global SetClusterGroupNodeList "SetClusterGroupNodeList" sptr, int, sptr
; res = SetClusterGroupNodeList(hGroup, NodeCount, varptr(NodeList))
; hGroup : HGROUP -> "sptr"
; NodeCount : DWORD -> "int"
; NodeList : HNODE* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。