able/windows-nt
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
windows-nt/Source/XPSP1/NT/base/cluster/service/idl/clusrpc.idl

1061 lines
25 KiB
Plaintext
Raw Normal View History

Add source files
2020-09-26 03:20:57 -05:00
/*++
Copyright (c) 1996 Microsoft Corporation
Module Name:
clusrpc.idl
Abstract:
Interface Description for Cluster RPC interface. This contains
two interfaces. The first is used for out-of-band cluster server
RPC and is used for things like Join. The second is stricly for
intra-cluster communications and runs only over the cluster
transport.
Author:
John Vert (jvert) 6/5/1996
--*/
cpp_quote("#ifndef _CLUSRPC_INCLUDED_")
cpp_quote("#define _CLUSRPC_INCLUDED_")
////////////////////////////////////////////////////////////////////////////
//
// Intracluster (Internal) RPC Interface Definition
//
////////////////////////////////////////////////////////////////////////////
[
uuid(e248d0b8-bf15-11cf-8c5e-08002bb49649),
version(2.0)
]
interface IntraCluster
{
import "wtypes.idl";
typedef WCHAR CLUSTER_ID[37]; // unicode representation of a GUID
//
// Interface descriptions for the FM component.
//
//
// Types
//
typedef [context_handle] void *HGROUP_ENUM_RPC;
//
// Routines and structures for dealing with Groups
//
//
// Cluster Group State
//
typedef enum _GROUP_STATE {
GroupOnline,
GroupOffline,
GroupFailed,
GroupPartialOnline
} GROUP_STATE;
//
// Group and Resource enumeration interface
//
typedef struct _GROUP_ENUM_ENTRY {
[string] LPWSTR Id;
DWORD State;
DWORD StateSequence;
} GROUP_ENUM_ENTRY, *PGROUP_ENUM_ENTRY;
typedef struct _GROUP_ENUM {
DWORD EntryCount;
[size_is(EntryCount)] GROUP_ENUM_ENTRY Entry[*];
} GROUP_ENUM, *PGROUP_ENUM;
typedef struct _RESOURCE_ENUM_ENTRY {
[string] LPWSTR Id;
DWORD State;
DWORD StateSequence;
} RESOURCE_ENUM_ENTRY, *PRESOURCE_ENUM_ENTRY;
typedef struct _RESOURCE_ENUM {
DWORD EntryCount;
int ContainsQuorum;
[size_is(EntryCount)] RESOURCE_ENUM_ENTRY Entry[*];
} RESOURCE_ENUM, *PRESOURCE_ENUM;
//
// Remotely arbitrate a group.
//
error_status_t
FmsQueryOwnedGroups(
[ out ] PGROUP_ENUM *OwnedGroups,
[ out ] PRESOURCE_ENUM *OwnedResources
);
//
// Remotely bring a group online.
//
error_status_t
FmsOnlineGroupRequest(
[ in ] LPCWSTR GroupId
);
//
// Remotely take a group offline.
//
error_status_t
FmsOfflineGroupRequest(
[ in ] LPCWSTR GroupId
);
//
// Remotely move a group.
//
error_status_t
FmsMoveGroupRequest(
[ in ] LPCWSTR GroupId,
[ in, unique ] LPCWSTR DestinationNode
);
//
// Remotely take a group.
//
error_status_t
FmsTakeGroupRequest(
[ in ] LPCWSTR GroupId,
[ in ] PRESOURCE_ENUM ResourceList
);
//
// Remotely bring a resource online.
//
error_status_t
FmsOnlineResourceRequest(
[ in ] LPCWSTR ResourceId
);
//
// Remotely take a resource offline.
//
error_status_t
FmsOfflineResourceRequest(
[ in ] LPCWSTR ResourceId
);
//
// Remotely change node list for a resource.
//
error_status_t
FmsChangeResourceNode(
[ in ] LPCWSTR ResourceId,
[ in ] LPCWSTR NodeId,
[ in ] BOOL Add
);
//
// Remotely arbitrate a resource.
//
error_status_t
FmsArbitrateResource(
[ in ] LPCWSTR ResourceId
);
//
// Remotely fail a resource.
//
error_status_t
FmsFailResource(
[ in ] LPCWSTR ResourceId
);
//
// Remotely create a resource.
//
error_status_t
FmsCreateResource(
[ in ] LPCWSTR GroupId,
[ in ] LPWSTR ResourceId,
[ in ] LPCWSTR ResourceName
);
//
// Remotely delete a resource.
//
error_status_t
FmsDeleteResource(
[ in ] LPCWSTR ResourceId
);
//
// Remotely synchronize the online/offline of a resource.
//
error_status_t
FmsQuoNodeOnlineResource(
[ in ] LPCWSTR ResourceId,
[ in ] LPCWSTR NodeId,
[ out ] LPDWORD State
);
error_status_t
FmsQuoNodeOfflineResource(
[ in ] LPCWSTR ResourceId,
[ in ] LPCWSTR NodeId,
[ out ] LPDWORD State
);
error_status_t
FmsRmOnlineResource(
[ in ] LPCWSTR ResourceId,
[ out ] LPDWORD State
);
error_status_t
FmsRmOfflineResource(
[ in ] LPCWSTR ResourceId,
[ out ] LPDWORD State
);
//
// Remotely control a resource.
//
error_status_t
FmsResourceControl(
[ in ] LPCWSTR ResourceId,
[ in ] DWORD ControlCode,
[ in, unique, size_is(InBufferSize) ] UCHAR *InBuffer,
[ in ] DWORD InBufferSize,
[ out, size_is(OutBufferSize), length_is(*BytesReturned) ] UCHAR *OutBuffer,
[ in ] DWORD OutBufferSize,
[ out ] LPDWORD BytesReturned,
[ out ] LPDWORD Required
);
//
// Remotely control a resource type.
//
error_status_t
FmsResourceTypeControl(
[ in ] LPCWSTR ResourceTypeName,
[ in ] DWORD ControlCode,
[ in, unique, size_is(InBufferSize) ] UCHAR *InBuffer,
[ in ] DWORD InBufferSize,
[ out, size_is(OutBufferSize), length_is(*BytesReturned) ] UCHAR *OutBuffer,
[ in ] DWORD OutBufferSize,
[ out ] LPDWORD BytesReturned,
[ out ] LPDWORD Required
);
//
// Remotely control a group.
//
error_status_t
FmsGroupControl(
[ in ] LPCWSTR GroupId,
[ in ] DWORD ControlCode,
[ in, unique, size_is(InBufferSize) ] UCHAR *InBuffer,
[ in ] DWORD InBufferSize,
[ out, size_is(OutBufferSize), length_is(*BytesReturned) ] UCHAR *OutBuffer,
[ in ] DWORD OutBufferSize,
[ out ] LPDWORD BytesReturned,
[ out ] LPDWORD Required
);
//
//Remotely prepare a resource to become the quorum resource(create quorum log file/take checkpoint)
//
error_status_t
FmsPrepareQuorumResChange(
[ in ] LPCWSTR ResourceId,
[ in ] LPCWSTR lpszQuoLogPath,
[ in ] DWORD dwMaxQuoLogSize
);
//
//Remotely ask the resource to relinquish being a quorum resource or prepare a tombstone in the previous
// location of quorum log files.
//
error_status_t
FmsCompleteQuorumResChange(
[ in ] LPCWSTR lpszResourceId,
[ in ] LPCWSTR lpszQuoLogPath
);
//
// Interface descriptions for the GUM component.
//
typedef UCHAR *PGUM_DATA;
error_status_t
GumQueueLockingUpdate(
[ in ] DWORD NodeId,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ out ] LPDWORD Sequence,
[ in ] DWORD BufferLength,
[ in,size_is(BufferLength) ] PGUM_DATA Buffer
);
#ifdef GUM_POST_SUPPORT
error_status_t
GumQueueLockingPost(
[ in ] DWORD NodeId,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ out ] LPDWORD Sequence,
[ in ] DWORD BufferLength,
[ in,size_is(BufferLength) ] PGUM_DATA Buffer,
[ in ] DWORD ActualBuffer
);
error_status_t
GumDeliverPostCallback(
[ in ] DWORD FirstNode,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ in ] DWORD Sequence,
[ in ] DWORD BufferLength,
[ in ] DWORD Buffer
);
#endif
error_status_t
GumAttemptJoinUpdate(
[ in ] DWORD JoiningId,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ in ] DWORD Sequence,
[ in ] DWORD BufferLength,
[ in,unique,size_is(BufferLength) ] PGUM_DATA Buffer
);
error_status_t
GumUnlockUpdate(
[ in ] DWORD Type,
[ in ] DWORD Sequence
);
error_status_t
GumUpdateNode(
[ in ] DWORD Type,
[ in ] DWORD Context,
[ in ] DWORD Sequence,
[ in ] DWORD BufferLength,
[ in,size_is(BufferLength) ] PGUM_DATA Buffer
);
error_status_t
GumJoinUpdateNode(
[ in ] DWORD JoiningId,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ in ] DWORD Sequence,
[ in ] DWORD BufferLength,
[ in,unique,size_is(BufferLength) ] PGUM_DATA Buffer
);
typedef struct _GUM_NODE_LIST {
DWORD NodeCount;
[size_is(NodeCount)] DWORD NodeId[*];
} GUM_NODE_LIST, *PGUM_NODE_LIST;
error_status_t
GumGetNodeSequence(
[ in ] DWORD Type,
[ out ] LPDWORD Sequence,
[ out ] LPDWORD LockerNodeId,
[ out ] PGUM_NODE_LIST *NodeList
);
//
// Interface descriptions for the MM component.
//
error_status_t
MmRpcMsgSend(
[ in, size_is(length) ] const UCHAR *buffer,
[ in ] DWORD length
);
//
// we can't import sspi.h but SECURITY_STATUS is an HRESULT
//
typedef enum _SECURITY_ROLE {
SecurityRoleJoiningMember = 1,
SecurityRoleClusterMember
} SECURITY_ROLE;
error_status_t
MmRpcEstablishSecurityContext(
[ in ] DWORD NmJoinSequence,
[ in ] DWORD EstablishingNodeId,
[ in ] BOOL FirstTime,
[ in ] SECURITY_ROLE RoleOfClient,
[ in, size_is(ServerContextLength) ] const UCHAR *ServerContext,
[ in ] DWORD ServerContextLength,
[ out, size_is(*ClientContextLength) ] UCHAR *ClientContext,
[ in, out ] DWORD * ClientContextLength,
[ out ] HRESULT * ServerStatus
);
error_status_t
MmRpcDeleteSecurityContext(
[ in ] DWORD NodeId
);
error_status_t
MmRpcBanishNode(
[ in ] DWORD NodeId
);
error_status_t
NmRpcCreateJoinerBinding(
[in] DWORD JoinSequence,
[in, string] LPWSTR JoinerNodeId,
[in, string] LPWSTR JoinerInterfaceId
);
error_status_t
NmRpcDeliverJoinMessage(
[ in, size_is(MessageLength) ] UCHAR *Message,
[ in ] DWORD MessageLength
);
//
// Interface descriptions for the Checkpoint Manager (CP)
//
typedef pipe byte BYTE_PIPE;
error_status_t
CpDepositCheckpoint(
[ in ] const CLUSTER_ID ResourceId,
[ in ] DWORD dwCheckpointId,
[ in ] BYTE_PIPE CheckpointData
);
error_status_t
CpRetrieveCheckpoint(
[ in ] const CLUSTER_ID ResourceId,
[ in ] DWORD dwCheckpointId,
[ out ] BYTE_PIPE CheckpointData
);
//
// Interface descriptions for the ClusterEventlog Manager (Evtlog)
//
error_status_t
EvPropEvents(
[ in ] DWORD dwEventInfoSize,
[in , size_is(dwEventInfoSize)] UCHAR *pPackedEventInfo
);
//
// Interface description for the Checkpoint managaer
//
error_status_t
CpDeleteCheckpoint(
[in] const CLUSTER_ID ResourceId,
[in] DWORD dwCheckpointId,
[in, unique] LPCWSTR lpszQuorumPath
);
//
// New structures and procedures added for version 2.0 (NT 5.0)
// that are understood by NT4 SP4.
//
//
// Global Update Manager
//
error_status_t
GumAttemptLockingUpdate(
[ in ] DWORD NodeId,
[ in ] DWORD Type,
[ in ] DWORD Context,
[ in ] DWORD Sequence,
[ in ] DWORD BufferLength,
[ in,size_is(BufferLength) ] PGUM_DATA Buffer
);
error_status_t
GumCollectVoteFromNode(
[ in ] DWORD UpdateType,
[ in ] DWORD dwContext,
[ in ] DWORD dwInputBufLength,
[ in, size_is(dwInputBufLength) ] UCHAR *pInputBuf,
[ in ] DWORD dwVoteLength,
[ out, size_is(dwVoteLength) ] UCHAR *pVoteBuf
);
//
// Node Manager
//
typedef UCHAR NM_STATE_ENTRY, *PNM_STATE_ENTRY;
typedef struct _NM_CONNECTIVITY_VECTOR {
DWORD EntryCount;
[ size_is(EntryCount) ] NM_STATE_ENTRY Data[*];
} NM_CONNECTIVITY_VECTOR, *PNM_CONNECTIVITY_VECTOR;
typedef struct _NM_ADDRESS_ENUM {
DWORD AddressSize;
DWORD AddressCount;
[size_is(AddressCount)] ULONGLONG AddressList[*];
} NM_ADDRESS_ENUM, *PNM_ADDRESS_ENUM;
error_status_t
NmRpcReportInterfaceConnectivity(
[ in, string ] LPWSTR ReportingInterfaceId,
[ in ] PNM_CONNECTIVITY_VECTOR ConnectivityVector
);
error_status_t
NmRpcGetInterfaceOnlineAddressEnum(
[ in, string ] LPWSTR InterfaceId,
[ out ] PNM_ADDRESS_ENUM * InterfaceAddressEnum
);
error_status_t
NmRpcGetInterfacePingAddressEnum(
[ in, string ] LPWSTR InterfaceId,
[ in ] PNM_ADDRESS_ENUM OnlineAddressEnum,
[ out ] PNM_ADDRESS_ENUM * PingAddressEnum
);
//
// This call returns void rather than error_status_t because of a
// bug in the MIDL compiler in an early beta of W2K. Making the
// status the last argument results in the same format on the wire,
// which will enable us to change the definition later and still
// interoperate. The call works in its current format, so there
// is little point in changing it.
//
void
NmRpcDoInterfacePing(
[ in ] LPWSTR InterfaceId,
[ in ] PNM_ADDRESS_ENUM PingAddressEnum,
[ out ] BOOLEAN * PingSucceeded,
[ out ] error_status_t * CallStatus
);
//
// Remotely request the owner of the quorum resource to make a backup of the
// quorum log file and the checkpoint file to the supplied directory path
//
error_status_t
FmsBackupClusterDatabase(
[ in ] LPCWSTR lpszResourceId,
[ in ] LPCWSTR lpszPathName
);
//
// Remotely change the group for a resource
//
error_status_t
FmsChangeResourceGroup(
[ in ] LPCWSTR ResourceId,
[ in ] LPCWSTR GroupId
);
//
// Remotely request the owner of the node to handle the delete group request.
//
error_status_t
FmsDeleteGroupRequest(
[ in ] LPCWSTR GroupId
);
//
// Interface descriptions for the Crypto Checkpoint Management (CP)
//
error_status_t
CpDepositCryptoCheckpoint(
[ in ] const CLUSTER_ID ResourceId,
[ in ] DWORD dwCheckpointId,
[ in ] BYTE_PIPE CheckpointData
);
error_status_t
CpRetrieveCryptoCheckpoint(
[ in ] const CLUSTER_ID ResourceId,
[ in ] DWORD dwCheckpointId,
[ out ] BYTE_PIPE CheckpointData
);
error_status_t
CpDeleteCryptoCheckpoint(
[in] const CLUSTER_ID ResourceId,
[in] DWORD dwCheckpointId,
[in, unique] LPCWSTR lpszQuorumPath
);
//
// Remotely add a resource dependency
//
error_status_t
FmsAddResourceDependency(
[ in ] LPCWSTR pszResourceId,
[ in ] LPCWSTR pszDependsOnId
);
//
// Remotely remove a resource dependency
//
error_status_t
FmsRemoveResourceDependency(
[ in ] LPCWSTR pszResourceId,
[ in ] LPCWSTR pszDependsOnId
);
//
// New structures and procedures added for version 2.0 (NT 5.0)
// that are not understood by NT4 SP4.
//
error_status_t
NmRpcAddNode(
[ in ] LPCWSTR NewNodeName,
[ in ] DWORD NewNodeHighestVersion,
[ in ] DWORD NewNodeLowestVersion,
[ in ] DWORD NewNodeProductSuite
);
error_status_t
FmsCreateResource2(
[ in ] LPCWSTR GroupId,
[ in ] LPWSTR ResourceId,
[ in ] LPCWSTR ResourceName,
[ in ] LPCWSTR ResourceType,
[ in ] DWORD dwFlags
);
} // IntraCluster interface
////////////////////////////////////////////////////////////////////////////
//
// ExtroCluster (Join) RPC Interface Definition
//
////////////////////////////////////////////////////////////////////////////
[
uuid(ffe561b8-bf15-11cf-8c5e-08002bb49649),
version(2.0)
]
interface ExtroCluster
{
import "wtypes.idl";
//
// Constants
//
const unsigned long CS_MAX_NODE_NAME_LENGTH = 15; // MAX_COMPUTERNAME_LENGTH
const unsigned long CS_MAX_NODE_ID_LENGTH = 5; // enough for 99,999 nodes
const unsigned long CS_NETWORK_ID_LENGTH = 36 ; // size of a GUID.
const unsigned long CS_NETINTERFACE_ID_LENGTH = 36 ; // size of a GUID.
//
// Node Configuration Information
//
typedef struct _NM_NODE_INFO {
[string] WCHAR NodeId[CS_MAX_NODE_ID_LENGTH + 1];
[string] WCHAR NodeName[CS_MAX_NODE_NAME_LENGTH + 1];
DWORD State;
} NM_NODE_INFO, *PNM_NODE_INFO;
typedef struct _NM_NODE_ENUM {
DWORD NodeCount;
[ size_is(NodeCount) ] NM_NODE_INFO NodeList[*];
} NM_NODE_ENUM, *PNM_NODE_ENUM;
//
// Network Configuration Information.
//
typedef struct _NM_INTERFACE_INFO {
[string] LPWSTR Id;
[string] LPWSTR Name;
[string] LPWSTR Description;
[string] LPWSTR NodeId;
[string] LPWSTR NetworkId;
[string] LPWSTR Adapter;
[string] LPWSTR Address;
[string] LPWSTR ClusnetEndpoint;
DWORD State;
BOOLEAN Ignore;
} NM_INTERFACE_INFO, *PNM_INTERFACE_INFO;
typedef struct _NM_INTERFACE_ENUM {
DWORD InterfaceCount;
[ size_is(InterfaceCount) ] NM_INTERFACE_INFO InterfaceList[*];
} NM_INTERFACE_ENUM, *PNM_INTERFACE_ENUM;
typedef struct _NM_NETWORK_INFO {
[string] LPWSTR Id;
[string] LPWSTR Name;
[string] LPWSTR Description;
DWORD Role;
DWORD Priority;
[string] LPWSTR Transport;
[string] LPWSTR Address;
[string] LPWSTR AddressMask;
BOOLEAN Ignore;
} NM_NETWORK_INFO, *PNM_NETWORK_INFO;
typedef struct _NM_NETWORK_ENUM {
DWORD NetworkCount;
[ size_is(NetworkCount) ] NM_NETWORK_INFO NetworkList[*];
} NM_NETWORK_ENUM, *PNM_NETWORK_ENUM;
//
// Routines
//
error_status_t
NmRpcEnumNodeDefinitions(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_NODE_ENUM * NodeEnum
);
error_status_t
NmRpcEnumNetworkDefinitions(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_NETWORK_ENUM * NetworkEnum
);
error_status_t
NmRpcEnumInterfaceDefinitions(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_INTERFACE_ENUM * InterfaceEnum
);
error_status_t
NmRpcCreateNetwork(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_NETWORK_INFO NetworkInfo,
[ in ] PNM_INTERFACE_INFO InterfaceInfo
);
error_status_t
NmRpcCreateInterface(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_INTERFACE_INFO InterfaceInfo
);
error_status_t
NmRpcSetInterfaceInfo(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_INTERFACE_INFO InterfaceInfo
);
error_status_t
NmRpcDeleteInterface(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in, string ] LPWSTR InterfaceId,
[ out ] BOOLEAN * NetworkDeleted
);
error_status_t
NmRpcJoinBegin(
[in, string ] LPWSTR JoinerNodeId,
[in, string ] LPWSTR JoinerNodeName,
[ out ] LPDWORD SponsorNodeId,
[ out ] LPDWORD JoinSequenceNumber,
[ out, string ] LPWSTR * ClusnetEndpoint
);
error_status_t
NmRpcCreateBinding(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in, string ] LPWSTR JoinerInterfaceId,
[ in, string ] LPWSTR MemberNodeId
);
error_status_t
NmRpcPetitionForMembership(
[ in ] DWORD JoinSequence,
[ in, string ] LPCWSTR JoinerNodeId
);
error_status_t
JoinAddNode(
[ in, string ] LPCWSTR lpszNodeId
);
error_status_t
DmSyncDatabase(
[ out ] BYTE_PIPE reg_data
);
error_status_t
TestRPCSecurity(
);
//
// New structures added for version 2.0 (NT 5.0) that are understood
// by NT4 SP4.
//
//
// Node Configuration Information Structure
//
typedef struct _NM_NODE_INFO2{
[string] WCHAR NodeId[CS_MAX_NODE_ID_LENGTH + 1];
[string] WCHAR NodeName[CS_MAX_NODE_NAME_LENGTH + 1];
DWORD State;
//
// New fields in Version 2.0
//
DWORD NodeHighestVersion;
DWORD NodeLowestVersion;
} NM_NODE_INFO2, *PNM_NODE_INFO2;
typedef struct _NM_NODE_ENUM2{
DWORD NodeCount;
[ size_is(NodeCount) ] NM_NODE_INFO2 NodeList[*];
} NM_NODE_ENUM2, *PNM_NODE_ENUM2;
//
// Network Interface Configuration Information Structure
//
// Extension of NM_INTERFACE_INFO structure. Extended fields
// are appended to the original structure.
//
typedef struct _NM_INTERFACE_INFO2 {
[string] LPWSTR Id;
[string] LPWSTR Name;
[string] LPWSTR Description;
[string] LPWSTR NodeId;
[string] LPWSTR NetworkId;
[string] LPWSTR AdapterName; // Field renamed, but location unchanged
[string] LPWSTR Address;
[string] LPWSTR ClusnetEndpoint;
DWORD State;
BOOLEAN Ignore;
//
// New fields in Version 2.0
//
[string] LPWSTR AdapterId;
DWORD NetIndex;
} NM_INTERFACE_INFO2, *PNM_INTERFACE_INFO2;
typedef struct _NM_INTERFACE_ENUM2 {
DWORD InterfaceCount;
[ size_is(InterfaceCount) ] NM_INTERFACE_INFO2 InterfaceList[*];
} NM_INTERFACE_ENUM2, *PNM_INTERFACE_ENUM2;
cpp_quote("#define NmInvalidInterfaceNetIndex 0xFFFFFFFF")
//
// Network Interface State Information Structure
//
typedef struct _NM_INTERFACE_STATE_INFO {
[string] LPWSTR Id;
DWORD State;
} NM_INTERFACE_STATE_INFO, *PNM_INTERFACE_STATE_INFO;
typedef struct _NM_INTERFACE_STATE_ENUM {
DWORD InterfaceCount;
[ size_is(InterfaceCount) ] NM_INTERFACE_STATE_INFO InterfaceList[*];
} NM_INTERFACE_STATE_ENUM, *PNM_INTERFACE_STATE_ENUM;
typedef struct _NM_NETWORK_STATE_INFO {
[string] LPWSTR Id;
DWORD State;
} NM_NETWORK_STATE_INFO, *PNM_NETWORK_STATE_INFO;
typedef struct _NM_NETWORK_STATE_ENUM {
DWORD NetworkCount;
[ size_is(NetworkCount) ] NM_NETWORK_STATE_INFO NetworkList[*];
} NM_NETWORK_STATE_ENUM, *PNM_NETWORK_STATE_ENUM;
//
// New routines added for version 2.0 (NT 5.0) that are understood
// by NT4 SP4.
//
error_status_t
NmRpcJoinBegin2(
[in, string ] LPWSTR JoinerNodeId,
[in, string ] LPWSTR JoinerNodeName,
[in ] DWORD JoinerHighestVersion,
[in ] DWORD JoinerLowestVersion,
[ out ] LPDWORD SponsorNodeId,
[ out ] LPDWORD JoinSequenceNumber,
[ out, string ] LPWSTR * ClusnetEndpoint
);
error_status_t
JoinAddNode2(
[ in, string ] LPCWSTR lpszNodeId,
[ in ] DWORD dwNodeHighestVersion,
[ in ] DWORD dwNodeLowestVersion
);
error_status_t
NmRpcEnumNodeDefinitions2(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_NODE_ENUM2 * NodeEnum2
);
error_status_t
NmRpcEnumInterfaceDefinitions2(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_INTERFACE_ENUM2 * InterfaceEnum2
);
error_status_t
NmRpcCreateNetwork2(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_NETWORK_INFO NetworkInfo,
[ in ] PNM_INTERFACE_INFO2 InterfaceInfo2
);
error_status_t
NmRpcCreateInterface2(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_INTERFACE_INFO2 InterfaceInfo2
);
error_status_t
NmRpcSetInterfaceInfo2(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_INTERFACE_INFO2 InterfaceInfo2
);
error_status_t
NmRpcSetNetworkName(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in ] PNM_NETWORK_INFO NetworkInfo
);
error_status_t
NmRpcReportJoinerInterfaceConnectivity(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ in, string ] LPWSTR ReportingInterfaceId,
[ in ] PNM_CONNECTIVITY_VECTOR ConnectivityVector
);
error_status_t
NmRpcEnumNetworkAndInterfaceStates(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] PNM_NETWORK_STATE_ENUM * NetworkStateEnum,
[ out ] PNM_INTERFACE_STATE_ENUM * InterfaceStateEnum
);
error_status_t
NmRpcGetLeaderNodeId(
[ in ] DWORD JoinSequence,
[ in, string ] LPWSTR JoinerNodeId,
[ out ] LPDWORD LeaderNodeId
);
//
// New structures and procedures added for version 2.0 (NT 5.0)
// that are not understood by NT4 SP4.
//
error_status_t
JoinAddNode3(
[ in, string ] LPCWSTR lpszNodeId,
[ in ] DWORD dwNodeHighestVersion,
[ in ] DWORD dwNodeLowestVersion,
[ in ] DWORD dwNodeProductSuite
);
//
// New structures and procedures added for version 2.1 (NT 5.1)
// that are not understood by NT 5.0 or earlier
//
error_status_t
NmRpcJoinBegin3(
[in, string ] LPWSTR JoinerClusterInstanceId,
[in, string ] LPWSTR JoinerNodeId,
[in, string ] LPWSTR JoinerNodeName,
[in ] DWORD JoinerHighestVersion,
[in ] DWORD JoinerLowestVersion,
[in ] DWORD JoinerMajorVersion,
[in ] DWORD JoinerMinorVersion,
[in, string ] LPWSTR JoinerCsdVersion,
[in ] DWORD JoinerProductSuite,
[ out ] LPDWORD SponsorNodeId,
[ out ] LPDWORD JoinSequenceNumber,
[ out, string ] LPWSTR * ClusnetEndpoint
);
} // ExtroCluster interface
////////////////////////////////////////////////////////////////////////////
//
// Join Version RPC Interface Definition
//
// Don't ever change this interface unless you really, really,
// really know what you're doing.
//
////////////////////////////////////////////////////////////////////////////
[
uuid(6e17aaa0-1a47-11d1-98bd-0000f875292e),
version(2.0)
]
interface JoinVersion
{
import "wtypes.idl";
error_status_t
CsRpcGetJoinVersionData(
[ in ] DWORD JoiningNodeId,
[ in ] DWORD JoinerHighestVersion,
[ in ] DWORD JoinerLowestVersion,
[ out ] LPDWORD SponsorNodeId,
[ out ] LPDWORD ClusterHighestVersion,
[ out ] LPDWORD ClusterLowestVersion,
[ out ] LPDWORD JoinStatus
);
} // JoinVersion interface
cpp_quote("#endif //_CLUSRPC_INCLUDED_")
Reference in a new issue Copy permalink