mirror of https://github.com/tongzx/nt5src
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4050 lines
122 KiB
4050 lines
122 KiB
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// Copyright (c) 2000-2001 Microsoft Corporation
|
|
//
|
|
// Module Name:
|
|
// ClusCfgServer.idl
|
|
//
|
|
// Description:
|
|
// This file is the IDL file for the IClusCfgServer interface of the
|
|
// Cluster Setup application.
|
|
//
|
|
// The IClusCfgServer interface provides the functions required to gather
|
|
// information about storage devices, networks, the operating
|
|
// system, etc. on a computer. It also has functions to form a cluster
|
|
// on this computer, to add this node to a cluster, to remove this node
|
|
// from a cluster, etc.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
// Comments for generated files
|
|
cpp_quote( "//////////////////////////////////////////////////////////////////////////////" )
|
|
cpp_quote( "//" )
|
|
cpp_quote( "// Copyright (c) 2000 Microsoft Corporation" )
|
|
cpp_quote( "//" )
|
|
cpp_quote( "// Remarks:" )
|
|
cpp_quote( "// Generated file. See file ClusCfgServer.idl for more details." )
|
|
cpp_quote( "//" )
|
|
cpp_quote( "//////////////////////////////////////////////////////////////////////////////" )
|
|
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
// Imported Files
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
// For IUnknown
|
|
import "unknwn.idl";
|
|
|
|
|
|
////////////////////////////////////////////////////////////////////////////
|
|
// Forward Declarations
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
interface IClusCfgNodeInfo;
|
|
interface IEnumClusCfgManagedResources;
|
|
interface IClusCfgManagedResourceInfo;
|
|
interface IEnumClusCfgNetworks;
|
|
interface IEnumClusCfgPartitions;
|
|
interface IClusCfgPartitionInfo;
|
|
interface IEnumClusCfgIPAddresses;
|
|
interface IClusCfgIPAddressInfo;
|
|
interface IClusCfgNetworkInfo;
|
|
interface IClusCfgClusterInfo;
|
|
interface IClusCfgInitialize;
|
|
interface IClusCfgCallback;
|
|
interface IClusCfgCredentials;
|
|
interface IClusCfgCapabilities;
|
|
|
|
interface IClusCfgManagedResourceCfg;
|
|
interface IClusCfgResourcePreCreate;
|
|
interface IClusCfgResourceCreate;
|
|
interface IClusCfgResourcePostCreate;
|
|
interface IClusCfgGroupCfg;
|
|
interface IClusCfgResourceTypeInfo;
|
|
interface IClusCfgResourceTypeCreate;
|
|
interface IClusCfgMemberSetChangeListener;
|
|
interface IClusCfgEvictCleanup;
|
|
interface IClusCfgStartupListener;
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
// Type Definitions
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
//
|
|
// This enumeration is used to indicate the differetnt usage
|
|
// states of a drive letter.
|
|
//
|
|
typedef enum
|
|
{
|
|
dluUNKNOWN = 0,
|
|
dluNO_ROOT_DIRECTORY,
|
|
dluREMOVABLE_DISK,
|
|
dluFIXED_DISK,
|
|
dluNETWORK_DRIVE,
|
|
dluCOMPACT_DISC,
|
|
dluRAM_DISK,
|
|
dluSYSTEM,
|
|
dluUNUSED,
|
|
dluMAX
|
|
} EDriveLetterUsage;
|
|
|
|
typedef struct _DRIVELETTERMAPPING {
|
|
EDriveLetterUsage dluDrives[ 26 ];
|
|
} SDriveLetterMapping;
|
|
|
|
//
|
|
// This enumeration is used to indicate the mode of the ClusCfgServer commit operation.
|
|
//
|
|
typedef enum
|
|
{
|
|
cmUNKNOWN = 0,
|
|
cmCREATE_CLUSTER,
|
|
cmADD_NODE_TO_CLUSTER,
|
|
cmCLEANUP_NODE_AFTER_EVICT,
|
|
cmMAX
|
|
} ECommitMode;
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
// Constant Definitions
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
// Interface Definitions
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgNodeInfo
|
|
//
|
|
// Description:
|
|
// This interface contains information about the node configuration.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( E4B5FA15-DD07-439e-A623-8823524E3D19 ),
|
|
async_uuid( 4F3BB40B-DF27-40a0-B31A-BA18324CEB9D ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgNodeInfo : IUnknown
|
|
{
|
|
//
|
|
// Name
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetName(
|
|
// [ out ] BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the node's fully qualified domain name. e.g.
|
|
// cluster1.ntdev.microsoft.com.
|
|
//
|
|
// Parameter:
|
|
// pbstrNameOut
|
|
// Pointer to the name of the node. This should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the new name for the node. This does not take effect until after
|
|
// the changes have been commited. This is stubbed out for future
|
|
// functionality.
|
|
//
|
|
// Parameter:
|
|
// pcszNameIn
|
|
// The new name for the node.
|
|
//
|
|
// Return Values:
|
|
// E_NOTIMPL
|
|
// The call is not implemented.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//
|
|
// Membership?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsMemberOfCluster( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the node is part of a cluster.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsMemberOfCluster( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetClusterConfigInfo(
|
|
// [ out ] IClusCfgClusterInfo ** ppClusCfgClusterInfoOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// If it is a member, use this method to obtain an interface to
|
|
// IClusCfgClusterInfo.
|
|
//
|
|
// Parameter:
|
|
// ppClusCfgClusterInfoOut
|
|
// Pointer to the IClusCfgClusterInfo interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetClusterConfigInfo( [ out ] IClusCfgClusterInfo ** ppClusCfgClusterInfoOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetOSVersion(
|
|
// [ out ] DWORD * pdwMajorVersionOut,
|
|
// [ out ] DWORD * pdwMinorVersionOut,
|
|
// [ out ] WORD * pwSuiteMaskOut,
|
|
// [ out ] BYTE * pbProductTypeOut,
|
|
// [ out ] BSTR * pbstrCSDVersionOut
|
|
// )
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetOSVersion(
|
|
[ out ] DWORD * pdwMajorVersionOut,
|
|
[ out ] DWORD * pdwMinorVersionOut,
|
|
[ out ] WORD * pwSuiteMaskOut,
|
|
[ out ] BYTE * pbProductTypeOut,
|
|
[ out ] BSTR * pbstrCSDVersionOut
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetClusterVersion(
|
|
// [ out ] DWORD * pdwNodeHighestVersion,
|
|
// [ out ] DWORD * pdwNodeLowestVersion
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the version of the cluster.
|
|
//
|
|
// Parameters:
|
|
// pdwNodeHighestVersion
|
|
// The highest version in the cluster.
|
|
//
|
|
// pdwNodeLowestVersion
|
|
// The lowest version in the cluster.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetClusterVersion(
|
|
[ out ] DWORD * pdwNodeHighestVersion,
|
|
[ out ] DWORD * pdwNodeLowestVersion
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetDriveLetterMappings(
|
|
// [ out ] SDriveLetterMapping dlmDriveLetterUsageOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the drive letter mappings on the node.
|
|
//
|
|
// Parameter:
|
|
// rgDriveLetterUsage
|
|
// An array of flags representing A: thru Z: (26) drive mappings to
|
|
// the device. See SDriveLetterMapping for flag values.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetDriveLetterMappings( [ out ] SDriveLetterMapping * pdlmDriveLetterUsageOut );
|
|
|
|
}; //*** interface IClusCfgNodeInfo
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IEnumClusCfgManagedResources
|
|
//
|
|
// Description:
|
|
// This interface enumerates all resources on this computer that the
|
|
// cluster service can manage.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 7DBE11EB-A5DF-4534-ABF6-8BAC7B53FC95 ),
|
|
async_uuid( B138483F-9695-4fa6-A98F-0DE2FB355449 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IEnumClusCfgManagedResources : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Next(
|
|
// [ in ] ULONG cNumberRequestedIn,
|
|
// [ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgManagedResourceInfo ** rgpManagedResourceInfoOut,
|
|
// [ out ] ULONG * pcNumberFetchedOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Retrieves the next cNumberRequestedIn items in the enumeration sequence.
|
|
// If there are fewer than the requested number of elements left in the
|
|
// sequence, it retrieves the remaining elements. The number of elements
|
|
// actually retrieved is returned through pcNumberFetchedOut (unless the
|
|
// caller passed in NULL for that parameter).
|
|
//
|
|
// Parameters:
|
|
// cNumberRequestedIn
|
|
// number of elements being requested.
|
|
//
|
|
// rgpManagedResourceInfoOut
|
|
// Array of size cNumberRequestedIn (or larger) of the elements of interest.
|
|
// The type of this parameter depends on the item being enumerated.
|
|
//
|
|
// pcNumberFetchedOut
|
|
// Pointer to the number of elements actually supplied in
|
|
// rgpManagedResourceInfoOut. Caller can pass in NULL if cNumberRequestedIn
|
|
// is one.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The number of elements supplied is cNumberRequestedIn
|
|
//
|
|
// S_FALSE
|
|
// The number of elements supplied is not cNumberRequestedIn
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Next(
|
|
[ in ] ULONG cNumberRequestedIn,
|
|
[ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgManagedResourceInfo ** rgpManagedResourceInfoOut,
|
|
[ out ] ULONG * pcNumberFetchedOut
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Reset( void );
|
|
//
|
|
// Description:
|
|
// Reset the enumeration sequence to the beginning.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Reset( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Skip(
|
|
// [ in ] ULONG cNumberToSkip
|
|
// );
|
|
//
|
|
// Description:
|
|
// Skips over the next specified number of elements in the enumeration sequence.
|
|
//
|
|
// Parameter:
|
|
// cNumberToSkip
|
|
// The number of elements to be skipped.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The number of elements skipped is cNumberToSkip.
|
|
//
|
|
// S_FALSE
|
|
// Success, but you're past the last element.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Skip( [ in ] ULONG cNumberToSkip );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Clone(
|
|
// [ out ] IEnumClusCfgManagedResources ** ppEnumManagedResources
|
|
// );
|
|
//
|
|
// Description:
|
|
// Creates another enumerator that contains the same enumeration state
|
|
// as the current one. Using this function, a client can record a
|
|
// particular point in the enumeration sequence, and then return to
|
|
// that point at a later time. The new enumerator supports the same
|
|
// interface as the original one.
|
|
//
|
|
// Return Values:
|
|
// E_INVALIDARG
|
|
// ppEnumManagedResources is invalid.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// E_UNEXPECTED
|
|
// Unknown error (it's in the EnumXXXX docs).
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Clone( [ out ] IEnumClusCfgManagedResources ** ppEnumManagedResourcesOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Count(
|
|
// [ out, ref ] DWORD * pnCountOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Returns the size (possibly zero) of the enumerator's collection.
|
|
//
|
|
// Return Values:
|
|
// E_POINTER
|
|
// pnCountOut was null.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Count( [ out, ref ] DWORD * pnCountOut );
|
|
|
|
}; //*** interface IEnumClusCfgManagedResources
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IEnumClusCfgNetworks
|
|
//
|
|
// Description:
|
|
// This interface enumerates the networks on this computer.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( CF3FAED8-1322-4bcb-9923-B5B745A69E36 ),
|
|
async_uuid( F56B9B0D-E7B8-49ec-A843-5475076B947D ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IEnumClusCfgNetworks : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Next(
|
|
// [ in ] ULONG cNumberRequestedIn,
|
|
// [ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgNetworkInfo ** rgpNetworkInfoOut,
|
|
// [ out ] ULONG * pcNumberFetchedOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Retrieves the next cNumberRequestedIn items in the enumeration sequence.
|
|
// If there are fewer than the requested number of elements left in the
|
|
// sequence, it retrieves the remaining elements. The number of elements
|
|
// actually retrieved is returned through pcNumberFetchedOut (unless the
|
|
// caller passed in NULL for that parameter).
|
|
//
|
|
// Parameters:
|
|
// cNumberRequestedIn
|
|
// number of elements being requested.
|
|
//
|
|
// rgpNetworkInfoOut
|
|
// Array of size cNumberRequestedIn (or larger) of the elements of interest.
|
|
// The type of this parameter depends on the item being enumerated.
|
|
//
|
|
// pcNumberFetchedOut
|
|
// Pointer to the number of elements actually supplied in
|
|
// rgpNetworkInfoOut. Caller can pass in NULL if cNumberRequestedIn
|
|
// is one.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The number of elements supplied is cNumberRequestedIn
|
|
//
|
|
// S_FALSE
|
|
// The number of elements supplied is not cNumberRequestedIn.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Next(
|
|
[ in ] ULONG cNumberRequestedIn,
|
|
[ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgNetworkInfo ** rgpNetworkInfoOut,
|
|
[ out ] ULONG * pcNumberFetchedOut
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Skip(
|
|
// [ in ] ULONG cNumberToSkip
|
|
// );
|
|
//
|
|
// Description:
|
|
// Skips over the next specified number of elements in the enumeration sequence.
|
|
//
|
|
// Parameter:
|
|
// cNumberToSkip
|
|
// The number of elements to be skipped.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The number of elements skipped is cNumberToSkip.
|
|
//
|
|
// S_FALSE
|
|
// Success, but you've past the last element.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Skip( [ in ] ULONG cNumberToSkipIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Reset( void );
|
|
//
|
|
// Description:
|
|
// Reset the enumeration sequence to the beginning.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Reset( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Clone(
|
|
// [ out ] IEnumClusCfgNetworks ** ppEnumNetworksOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Creates another enumerator that contains the same enumeration state
|
|
// as the current one. Using this function, a client can record a
|
|
// particular point in the enumeration sequence, and then return to
|
|
// that point at a later time. The new enumerator supports the same
|
|
// interface as the original one.
|
|
//
|
|
// Parameter:
|
|
// ppEnumNetworksOut
|
|
// Address of IEnumClusCfgManagedResources * pointer variable that receives
|
|
// the interface pointer to the enumeration object. If the method is
|
|
// unsuccessful, the value of this output variable is undefined.
|
|
//
|
|
// Return Values:
|
|
// E_INVALIDARG
|
|
// ppEnumNetworksOut is invalid.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// E_UNEXPECTED
|
|
// Unknown error (it's in the EnumXXXX docs).
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Clone( [ out ] IEnumClusCfgNetworks ** ppEnumNetworksOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Count(
|
|
// [ out, ref ] DWORD * pnCountOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Returns the size (possibly zero) of the enumerator's collection.
|
|
//
|
|
// Return Values:
|
|
// E_POINTER
|
|
// pnCountOut was null.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Count( [ out, ref ] DWORD * pnCountOut );
|
|
|
|
}; //*** interface IEnumClusCfgNetworks
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgManagedResourceInfo
|
|
//
|
|
// Description:
|
|
// This interface encapsulates a manageable resource on this computer.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( E0324847-1520-41b0-B960-54198DA5F8AF ),
|
|
async_uuid( 73616028-1243-4749-AD84-0B5EB358FFA0 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgManagedResourceInfo : IUnknown
|
|
{
|
|
//
|
|
// UID
|
|
//
|
|
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetUID(
|
|
// [ out ] BSTR * pbstrUIDOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieve the Unique IDentifier for this device. This is not a Universally
|
|
// Unique IDentifier (UUID or GUID). This indentifer should match identifiers
|
|
// that can be generated on other nodes that can see this device from a shared
|
|
// bus (such as a SCSI device).
|
|
//
|
|
// Parameters:
|
|
// pbstrUIDOut
|
|
// Pointer to the UID string. pbstrUIDOut should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetUID( [ out ] BSTR * pbstrUIDOut );
|
|
|
|
//
|
|
// Name
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetName(
|
|
// [ out ] BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves a "user friendly" name of the device.
|
|
//
|
|
// Parameter:
|
|
// pbstrNameOut
|
|
// Pointer to device name. This should be freed by the caller by calling
|
|
// SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name for the device to be set when the cluster
|
|
// configuration is commited.
|
|
//
|
|
// Parameter:
|
|
// pcszNameIn
|
|
// The name of the user wants to assigned the device.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//
|
|
// Managed by cluster?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsManaged( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the device is/will be managed by the cluster.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsManaged( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetManaged(
|
|
// [ in ] BOOL fIsManagedIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Setting this flag will cause the device to be configured as being managed
|
|
// by the cluster.
|
|
//
|
|
// Parameter:
|
|
// fIsManagedIn
|
|
// If TRUE, the device will be marked as being managed by the cluster.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetManaged( [ in ] BOOL fIsManagedIn );
|
|
|
|
//
|
|
// Quorum Device?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsQuorumDevice( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the device is/will be set as the quorum
|
|
// device.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsQuorumDevice( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetQuorumedDevice(
|
|
// [ in ] BOOL fIsQuorumDeviceIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Setting this flag will cause the device to be configured as the
|
|
// quorum device in the cluster.
|
|
//
|
|
// Parameter:
|
|
// fIsQuorumDeviceIn
|
|
// If TRUE, the device will be marked to be the quorum device.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_UNEXPECTED
|
|
// You tried to set a device to be the quorum when the device is not
|
|
// capable of being a quorum device.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetQuorumedDevice( [ in ] BOOL fIsQuorumDeviceIn );
|
|
|
|
//
|
|
// Quorum Capable?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsQuorumCapable( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the device is capable be set as the quorum
|
|
// device.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsQuorumCapable( void );
|
|
|
|
//
|
|
// Drive Letter Mapping
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetDriveLetterMappings(
|
|
// [ out ] SDriveLetterMapping dlmDriveLetterMappingsOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the drive mappings for the device (if any).
|
|
//
|
|
// Parameter:
|
|
// rgDriveLetterMappings
|
|
// An array of flags representing A: thru Z: (26) drive mappings to
|
|
// the device. See SDriveLetterMapping for flag values.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetDriveLetterMappings( [ out ] SDriveLetterMapping * pdlmDriveLetterMappingOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetDriveLetterMappings(
|
|
// [ in ] SDriveLetterMapping dlmDriveLetterMappingIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the drive mappings for the device. The change will not take
|
|
// effect until the configuration has been committed.
|
|
//
|
|
// Parameter:
|
|
// rgDriveLetterMappings
|
|
// An array of flags representing A: thru Z: (26) drive mappings to
|
|
// the device. See EDriveLetterUsage for flag values.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDriveLetterMappings( [ in ] SDriveLetterMapping dlmDriveLetterMappingIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsDeviceJoinable( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the quorum capable device allows other nodes
|
|
// to join.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsDeviceJoinable( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetDeviceJoinable(
|
|
// [ in ] BOOL fJoinableIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Call this to set the joinable flag.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDeviceJoinable( [ in ] BOOL fJoinableIn );
|
|
|
|
}; //*** interface IClusCfgManagedResourceInfo
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IEnumClusCfgPartitions
|
|
//
|
|
// Description:
|
|
// This interface enumerates the partitions on a storage device that the
|
|
// cluster service can manage.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 4440BB6A-B0AC-479d-B534-7265A31D6C55 ),
|
|
async_uuid( 4440BB6A-B0AC-479d-B534-7265A31D6C56 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IEnumClusCfgPartitions : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Next(
|
|
// [ in ] ULONG cNumberRequestedIn,
|
|
// [ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgPartitionInfo ** rgpPartitionInfoOut,
|
|
// [ out ] ULONG * pcNumberFetchedOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Retrieves the next cNumberRequestedIn items in the enumeration sequence.
|
|
// If there are fewer than the requested number of elements left in the
|
|
// sequence, it retrieves the remaining elements. The number of elements
|
|
// actually retrieved is returned through pcNumberFetchedOut (unless the
|
|
// caller passed in NULL for that parameter).
|
|
//
|
|
// Parameters:
|
|
// cNumberRequestedIn
|
|
// number of elements being requested.
|
|
//
|
|
// rgpPartitionInfoOut
|
|
// Array of size cNumberRequestedIn (or larger) of the elements of interest.
|
|
// The type of this parameter depends on the item being enumerated.
|
|
//
|
|
// pcNumberFetchedOut
|
|
// Pointer to the number of elements actually supplied in
|
|
// rgpPartitionInfoOut. Caller can pass in NULL if cNumberRequestedIn
|
|
// is one.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The number of elements supplied is cNumberRequestedIn
|
|
//
|
|
// S_FALSE
|
|
// The number of elements supplied is not cNumberRequestedIn
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Next(
|
|
[ in ] ULONG cNumberRequestedIn,
|
|
[ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgPartitionInfo ** rgpPartitionInfoOut,
|
|
[ out ] ULONG * pcNumberFetchedOut
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Reset( void );
|
|
//
|
|
// Description:
|
|
// Reset the enumeration sequence to the beginning.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Reset( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Skip(
|
|
// [ in ] ULONG cNumberToSkip
|
|
// );
|
|
//
|
|
// Description:
|
|
// Skips over the next specified number of elements in the enumeration sequence.
|
|
//
|
|
// Parameter:
|
|
// cNumberToSkip
|
|
// The number of elements to be skipped.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The number of elements skipped is cNumberToSkip.
|
|
//
|
|
// S_FALSE
|
|
// Success, but you've past the last element.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Skip( [ in ] ULONG cNumberToSkip );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Clone(
|
|
// [ out ] IEnumClusCfgPartitions ** ppEnumPartitions
|
|
// );
|
|
//
|
|
// Description:
|
|
// Creates another enumerator that contains the same enumeration state
|
|
// as the current one. Using this function, a client can record a
|
|
// particular point in the enumeration sequence, and then return to
|
|
// that point at a later time. The new enumerator supports the same
|
|
// interface as the original one.
|
|
//
|
|
// Return Values:
|
|
// E_INVALIDARG
|
|
// ppEnumPartitions is invalid.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// E_UNEXPECTED
|
|
// Unknown error (it's in the EnumXXXX docs).
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Clone( [ out ] IEnumClusCfgPartitions ** ppEnumPartitions );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Count(
|
|
// [ out, ref ] DWORD * pnCountOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Returns the size (possibly zero) of the enumerator's collection.
|
|
//
|
|
// Return Values:
|
|
// E_POINTER
|
|
// pnCountOut was null.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Count( [ out, ref ] DWORD * pnCountOut );
|
|
|
|
}; //*** interface IEnumClusCfgPartitions
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgPartitionInfo
|
|
//
|
|
// Description:
|
|
// This interface provides the partition info.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( EC1EBD9F-5866-4846-8952-EC36C3961EEE ),
|
|
async_uuid( EC1EBD9F-5866-4846-8952-EC36C3961EEF ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgPartitionInfo : IUnknown
|
|
{
|
|
//
|
|
// UID
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetUID(
|
|
// [ out ] BSTR * pbstrUIDOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieve the "Unique IDentifier" for this partition. This is not a Universally
|
|
// Unique IDentifier (UUID or GUID). This indentifer should match identifiers
|
|
// that can be generated on other nodes, but must be unique for the partition
|
|
// the interface (NIC) is on.
|
|
//
|
|
// Parameters:
|
|
// pbstrUIDOut
|
|
// Pointer to the UID string. pbstrUIDOut should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetUID( [ out ] BSTR * pbstrUIDOut );
|
|
|
|
//
|
|
// Name
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetName(
|
|
// [ out ] BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves a "user friendly" name of the interface.
|
|
//
|
|
// Parameter:
|
|
// pbstrNameOut
|
|
// Pointer to partition interface name. This should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name of the partition interface to be set when the cluster
|
|
// configuration is commited.
|
|
//
|
|
// Parameter:
|
|
// pcszNameIn
|
|
// The name of the user wants to assigned the interface.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//
|
|
// Description
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetDescription(
|
|
// [ out ] BSTR * pbstrDescriptionOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the description string for a partition interface.
|
|
//
|
|
// Parameter:
|
|
// pbstrDescription
|
|
// Pointer to the description of the partition. This should be freed
|
|
// by the caller by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetDescription( [ out ] BSTR * pbstrDescriptionOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetDescription(
|
|
// [ in ] LPCWSTR pcszDescriptionIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name of the partition interface to be set when the cluster
|
|
// configuration is commited.
|
|
//
|
|
// Parameter:
|
|
// pcszDescriptionIn
|
|
// The description the user wants to assign to the interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDescription(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszDescriptionIn
|
|
);
|
|
|
|
//
|
|
// Drive Letter Mapping
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetDriveLetterMappings(
|
|
// [ out ] SDriveLetterMapping dlmDriveLetterUsageOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the drive letter mappings of the partition.
|
|
//
|
|
// Parameter:
|
|
// rgDriveLetterUsage
|
|
// An array of flags representing A: thru Z: (26) drive mappings to
|
|
// the device. See SDriveLetterMapping for flag values.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetDriveLetterMappings( [ out ] SDriveLetterMapping * pdlmDriveLetterUsageOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetDriveLetterMappings(
|
|
// [ in ] SDriveLetterMapping dlmDriveLetterMappingIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the drive mappings for the device. The change will not take
|
|
// effect until the configuration has been committed.
|
|
//
|
|
// Parameter:
|
|
// rgDriveLetterMappings
|
|
// An array of flags representing A: thru Z: (26) drive mappings to
|
|
// the device. See EDriveLetterUsage for flag values.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDriveLetterMappings( [ in ] SDriveLetterMapping dlmDriveLetterMappingIn );
|
|
|
|
//
|
|
// Partition Size
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetSize(
|
|
// [ out ] ULONG * pcMegaBytes
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the size of the partition in Megabytes.
|
|
//
|
|
// Parameter:
|
|
// pcMegaBytes
|
|
// Retrieves the partition size.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetSize( [ out ] ULONG * pcMegaBytes );
|
|
|
|
}; //*** interface IClusCfgPartitionInfo
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IEnumClusCfgIPAddresses
|
|
//
|
|
// Description:
|
|
// This interface enumerates the IP addresses on this adapter.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( BD5F35BA-0BC0-455f-926D-C3D356419486 ),
|
|
async_uuid( BD5F35BA-0BC0-455f-926D-C3D356419487 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IEnumClusCfgIPAddresses : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Next(
|
|
// [ in ] ULONG cNumberRequestedIn,
|
|
// [ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgIPAddressInfo ** rgpIPAddressInfoOut,
|
|
// [ out ] ULONG * pcNumberFetchedOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Retrieves the next cNumberRequestedIn items in the enumeration sequence.
|
|
// If there are fewer than the requested number of elements left in the
|
|
// sequence, it retrieves the remaining elements. The number of elements
|
|
// actually retrieved is returned through pcNumberFetchedOut (unless the
|
|
// caller passed in NULL for that parameter).
|
|
//
|
|
// Parameters:
|
|
// cNumberRequestedIn
|
|
// number of elements being requested.
|
|
//
|
|
// rgpIPAddressInfoOut
|
|
// Array of size cNumberRequestedIn (or larger) of the elements of interest.
|
|
// The type of this parameter depends on the item being enumerated.
|
|
//
|
|
// pcNumberFetchedOut
|
|
// Pointer to the number of elements actually supplied in
|
|
// rgpIPAddressInfoOut. Caller can pass in NULL if cNumberRequestedIn
|
|
// is one.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The number of elements supplied is cNumberRequestedIn
|
|
//
|
|
// S_FALSE
|
|
// The number of elements supplied is not cNumberRequestedIn.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Next(
|
|
[ in ] ULONG cNumberRequestedIn,
|
|
[ out, size_is( cNumberRequestedIn ), length_is(*pcNumberFetchedOut) ] IClusCfgIPAddressInfo ** rgpIPAddressInfoOut,
|
|
[ out ] ULONG * pcNumberFetchedOut
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Skip(
|
|
// [ in ] ULONG cNumberToSkip
|
|
// );
|
|
//
|
|
// Description:
|
|
// Skips over the next specified number of elements in the enumeration sequence.
|
|
//
|
|
// Parameter:
|
|
// cNumberToSkip
|
|
// The number of elements to be skipped.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The number of elements skipped is cNumberToSkip.
|
|
//
|
|
// S_FALSE
|
|
// Success, but you've past the last element.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Skip( [ in ] ULONG cNumberToSkipIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Reset( void );
|
|
//
|
|
// Description:
|
|
// Reset the enumeration sequence to the beginning.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Reset( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Clone(
|
|
// [ out ] IEnumClusCfgIPAddresses ** ppEnumIPAddressesOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Creates another enumerator that contains the same enumeration state
|
|
// as the current one. Using this function, a client can record a
|
|
// particular point in the enumeration sequence, and then return to
|
|
// that point at a later time. The new enumerator supports the same
|
|
// interface as the original one.
|
|
//
|
|
// Parameter:
|
|
// ppEnumIPAddressesOut
|
|
// Address of IEnumClusCfgManagedResources * pointer variable that receives
|
|
// the interface pointer to the enumeration object. If the method is
|
|
// unsuccessful, the value of this output variable is undefined.
|
|
//
|
|
// Return Values:
|
|
// E_INVALIDARG
|
|
// ppEnumIPAddressesOut is invalid.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// E_UNEXPECTED
|
|
// Unknown error (it's in the EnumXXXX docs).
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Clone( [ out ] IEnumClusCfgIPAddresses ** ppEnumIPAddressesOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Count(
|
|
// [ out, ref ] DWORD * pnCountOut
|
|
// );
|
|
//
|
|
// Description:
|
|
// Returns the size (possibly zero) of the enumerator's collection.
|
|
//
|
|
// Return Values:
|
|
// E_POINTER
|
|
// pnCountOut was null.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Count( [ out, ref ] DWORD * pnCountOut );
|
|
|
|
}; //*** interface IEnumClusCfgIPAddresses
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgIPAddressInfo
|
|
//
|
|
// Description:
|
|
// This interface encapsulates the info about an IP address.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( AAEAF0A5-E310-4604-A55E-2F9DDC4157A8 ),
|
|
async_uuid( AAEAF0A5-E310-4604-A55E-2F9DDC4157A9 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgIPAddressInfo : IUnknown
|
|
{
|
|
//
|
|
// UID
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetUID(
|
|
// [ out ] BSTR * pbstrUIDOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieve the "Unique IDentifier" for this IP address. This is not a Universally
|
|
// Unique IDentifier (UUID or GUID). This indentifer should match identifiers
|
|
// that can be generated on other nodes, but must be unique for the network
|
|
// the interface (NIC) is on.
|
|
//
|
|
// Parameters:
|
|
// pbstrUIDOut
|
|
// Pointer to the UID string. pbstrUIDOut should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetUID( [ out ] BSTR * pbstrUIDOut );
|
|
|
|
//
|
|
// IP Address
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetIPAddress(
|
|
// [ out ] ULONG * pulDottedQuadOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves an IP Address for the network inteface.
|
|
//
|
|
// Paramater:
|
|
// pulDottedQuadOut
|
|
// The IP address of the interface in dotted quad format.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetIPAddress( [ out ] ULONG * pulDottedQuadOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetIPAddress(
|
|
// [ in ] ULONG ulDottedQuadIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores an IP Address of the network interface to be set when the cluster
|
|
// configuration is committed.
|
|
//
|
|
// Parameter:
|
|
// ulDottedQuadIn
|
|
// The IP address of the interface to be stored in dotted quad format.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetIPAddress( [ in ] ULONG ulDottedQuadIn );
|
|
|
|
//
|
|
// Subnet Mask
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetSubnetMask(
|
|
// [ out ] ULONG * pulDottedQuadOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves a subnet mask for the network interface.
|
|
//
|
|
// Parameter:
|
|
// ulDottedQuadOut
|
|
// The subnet mask of the interface in dotted quad format.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetSubnetMask( [ out ] ULONG * pulDottedQuadOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetSubnetMask(
|
|
// [ in ] ULONG ulDottedQuadIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a subnet mask for the network interface to be set when the cluster
|
|
// configuration is committed.
|
|
//
|
|
// Parameter:
|
|
// ulDottedQuadIn
|
|
// The subnet mask of the interface to be stored in dotted quad format.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetSubnetMask( [ in ] ULONG ulDottedQuadIn );
|
|
|
|
}; //*** interface IClusCfgIPAddressInfo
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgNetworkInfo
|
|
//
|
|
// Description:
|
|
// This interface enumerates the networks on this computer.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 19FC7580-950A-44a6-966E-74B14B20918F ),
|
|
async_uuid( ED71FD2D-AD02-4dfc-B376-5FFA5F5A7C2C ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgNetworkInfo : IUnknown
|
|
{
|
|
//
|
|
// UID
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetUID(
|
|
// [ out ] BSTR * pbstrUIDOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieve the "Unique IDentifier" for this network. This is not a Universally
|
|
// Unique IDentifier (UUID or GUID). This indentifer should match identifiers
|
|
// that can be generated on other nodes, but must be unique for the network
|
|
// the interface (NIC) is on.
|
|
//
|
|
// Parameters:
|
|
// pbstrUIDOut
|
|
// Pointer to the UID string. pbstrUIDOut should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetUID( [ out ] BSTR * pbstrUIDOut );
|
|
|
|
//
|
|
// Name
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetName(
|
|
// [ out ] BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves a "user friendly" name of the interface.
|
|
//
|
|
// Parameter:
|
|
// pbstrNameOut
|
|
// Pointer to network interface name. This should be freed by the caller
|
|
// by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name of the network interface to be set when the cluster
|
|
// configuration is commited.
|
|
//
|
|
// Parameter:
|
|
// pcszNameIn
|
|
// The name of the user wants to assigned the interface.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//
|
|
// Description
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetDescription(
|
|
// [ out ] BSTR * pbstrDescriptionOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the description string for a network interface.
|
|
//
|
|
// Parameter:
|
|
// pbstrDescription
|
|
// Pointer to the description of the network. This should be freed
|
|
// by the caller by calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetDescription( [ out ] BSTR * pbstrDescriptionOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetDescription(
|
|
// [ in ] LPCWSTR pcszDescriptionIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name of the network interface to be set when the cluster
|
|
// configuration is commited.
|
|
//
|
|
// Parameter:
|
|
// pcszDescriptionIn
|
|
// The description the user wants to assign to the interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDescription(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszDescriptionIn
|
|
);
|
|
|
|
//
|
|
// Network Address
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetPrimaryNetworkAddress(
|
|
// [ out ] IClusCfgIPAddressInfo ** ppIPAddressOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Get the primary network address.
|
|
//
|
|
// Parameter:
|
|
// ppIPAddressOut
|
|
// Pointer to the IClusCfgIPAddressInfo interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetPrimaryNetworkAddress( [ out ] IClusCfgIPAddressInfo ** ppIPAddressOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetPrimaryNetworkAddress(
|
|
// [ in ] IClusCfgIPAddressInfo * pIPAddressIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Set the primary network address.
|
|
//
|
|
// Parameter:
|
|
// pIPAddressIn
|
|
// Pointer to the IClusCfgIPAddressInfo interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPrimaryNetworkAddress( [ in ] IClusCfgIPAddressInfo * pIPAddressIn );
|
|
|
|
//
|
|
// Public?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsPublic( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the network has been configured to be a
|
|
// public network. Note that an interface can be both public and private.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
//
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsPublic( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetPublic(
|
|
// [ in ] BOOL fIsPublicIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Sets the "public property" of a network interface. The change will not
|
|
// take effect until the configuration has been committed.
|
|
//
|
|
// Parameter:
|
|
// fIsPublicIn
|
|
// If TRUE, the interface will be marked to be a public interface.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPublic( [ in ] BOOL fIsPublicIn );
|
|
|
|
//
|
|
// Private?
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IsPrivate( void )
|
|
//
|
|
// Description:
|
|
// Call this to determine if the network has been configured to be a
|
|
// private network. Note that an interface can be both public and private.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded and the result is "TRUE."
|
|
// S_FALSE
|
|
// Call succeeded and the result is "FALSE."
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
IsPrivate( void );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetPrivate(
|
|
// [ in ] BOOL fIsPrivateIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Sets the "private property" of a network interface. The change will not
|
|
// take effect until the configuration has been committed.
|
|
//
|
|
// Parameter:
|
|
// fIsPrivateIn
|
|
// Value to set the flag to. If TRUE the interface will be marked as
|
|
// a private interface. If FALSE the interface will be marked as NOT
|
|
// a private interface.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPrivate( [ in ] BOOL fIsPrivateIn );
|
|
|
|
}; //*** interface IClusCfgNetworkInfo
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgClusterInfo
|
|
//
|
|
// Description:
|
|
// This interface contains information about the cluster configuration.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 85B4BBC0-DDC4-4ae7-8268-F4850BB2A6EE ),
|
|
async_uuid( 8BDBA247-04F5-4114-837E-B263412A4B64 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgClusterInfo : IUnknown
|
|
{
|
|
//
|
|
// CommitChanges Mode
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetCommitMode(
|
|
// [ in ] ECommitMode ecmNewModeIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Sets the CommitChanges processing to be the new mode that
|
|
/// is passed in.
|
|
//
|
|
// Parameter:
|
|
// eccbNewModeIn
|
|
// The new mode to set the CommitChanges processing to.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeed.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetCommitMode( [ in ] ECommitMode ecmNewModeIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetCommitMode(
|
|
// [ out ] ECommitMode * pecmCurrentModeOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Call this to determine the operation that will be done when
|
|
// CommitChanges is invoked.
|
|
//
|
|
// Parameter:
|
|
// pecmCurrentModeOut
|
|
// The current mode for CommitChanges processing.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Call succeeded.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetCommitMode( [ out ] ECommitMode * pecmCurrentModeOut );
|
|
|
|
//
|
|
// Cluster Name
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetName(
|
|
// [ out ] BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the name of the cluster to be formed or joined.
|
|
//
|
|
// Notes:
|
|
// Name (Fully Qualified Domiain Name) e.g. cluster1.ntdev.microsoft.com
|
|
//
|
|
// In Forming the cluster, this is the resulting cluster name.
|
|
// In Joining the cluster, this is the sponsers cluster name.
|
|
//
|
|
// Parameter:
|
|
// pbstrNameOut
|
|
// Pointer to device name. This should be freed by the caller by calling
|
|
// SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores a new name for the cluster to be set when the cluster
|
|
// configuration is commited. If the node is joining, then this will
|
|
/// will be the cluster to be joined.
|
|
//
|
|
// Notes:
|
|
// Name (Fully Qualified Domiain Name) e.g. cluster1.ntdev.microsoft.com
|
|
//
|
|
// In Forming the cluster, this is the resulting cluster name.
|
|
// In Joining the cluster, this is the sponsers cluster name.
|
|
//
|
|
// Parameter:
|
|
// pcszNameIn
|
|
// The name of the user wants to assigned the device.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//
|
|
// Cluster IP Address
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetIPAddress(
|
|
// [ out ] ULONG * pulDottedQuadOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the IP address of the cluster.
|
|
//
|
|
// Parameter:
|
|
// pulDottedQuadOut
|
|
// The IP address of the cluster in dotted quad format.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetIPAddress( [ out ] ULONG * pulDottedQuadOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetIPAddress(
|
|
// [ in ] ULONG ulDottedQuadIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the IP address to be used to form the cluster. If joining,
|
|
// this is the IP address of the sponsor.
|
|
//
|
|
// Parameter:
|
|
// ulDottedQuadIn
|
|
// IP address in dotted quad format.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetIPAddress( [ in ] ULONG ulDottedQuadIn );
|
|
|
|
|
|
//
|
|
// Cluster Subnet Mask
|
|
//
|
|
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetSubnetMask(
|
|
// [ out ] ULONG * pulDottedQuadOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the subnet mask to be used for the cluster.
|
|
//
|
|
// Parameter:
|
|
// pulDottedQuadOut
|
|
// Subnet mask of the cluster in dotted quad format.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetSubnetMask( [ out ] ULONG * pulDottedQuadOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetSubnetMask(
|
|
// [ in ] ULONG ulDottedQuadIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the subnet mask to be used to form the cluster. If joining,
|
|
// this is the subnet mask of the sponsor.
|
|
//
|
|
// Parameter:
|
|
// ulDottedQuadIn
|
|
// Subnet mask in dotted quad format.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetSubnetMask( [ in ] ULONG ulDottedQuadIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetNetworkInfo(
|
|
// [ out ] IClusCfgNetworkInfo ** ppiccniOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the network to be used for the cluster IP address
|
|
// and name.
|
|
//
|
|
// Parameter:
|
|
// ppiccniOut
|
|
// Pointer of the network to use for the cluster IP address
|
|
// and name.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetNetworkInfo( [ out ] IClusCfgNetworkInfo ** ppiccniOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetNetworkInfo(
|
|
// [ in ] IClusCfgNetworkInfo * piccniIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the network to be used for the cluster IP address and name.
|
|
//
|
|
// Parameter:
|
|
// piccniIn
|
|
// Pointer to the network to use for the cluster IP address
|
|
// and name.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetNetworkInfo( [ in ] IClusCfgNetworkInfo * piccniIn );
|
|
|
|
//
|
|
// Cluster Service Account
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetClusterServiceAccountCredentials(
|
|
// [ out ] IClusCfgCredentials ** ppicccCredentialsOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the cluster service account credentials used by the
|
|
// cluster for authenication. The password is not available from the
|
|
// sponsor node and must be supplied by the user. Once supplied, it can
|
|
// be retrieved by calling this method.
|
|
//
|
|
// Parameters:
|
|
// ppicccCredentialsOut
|
|
// An IClusCfgCredentials * that contains the cluster
|
|
// service account credentials.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The called succeeded.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetClusterServiceAccountCredentials(
|
|
[ out ] IClusCfgCredentials ** ppicccCredentialsOut
|
|
);
|
|
|
|
//
|
|
// Cluster Binding String
|
|
//
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetBindingString(
|
|
// [ out ] BSTR * pbstrBindingStringOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the binding string (IP address) of the cluster to be
|
|
// formed or joined.
|
|
//
|
|
// Notes:
|
|
//
|
|
// Parameter:
|
|
// pbstrBindingStringOut
|
|
// Pointer to a BSTR. This should be freed by the caller by
|
|
// calling SysFreeString( ).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetBindingString( [ out ] BSTR * pbstrBindingStringOut );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetBindingString(
|
|
// [ in ] LPCWSTR pcszBindingStringIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Stores the binding string for the cluster.
|
|
//
|
|
// Notes:
|
|
//
|
|
// Parameter:
|
|
// pcszBindingStringIn
|
|
// The binding string to use when connecting to this cluster.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULT
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetBindingString(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszBindingStringIn
|
|
);
|
|
|
|
}; //*** interface IClusCfgClusterInfo
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgInitialize
|
|
//
|
|
// Description:
|
|
// This interface is used to initialize a configuration object.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 2A0EB82D-F878-492a-951E-AE000918C4A6 ),
|
|
async_uuid( 2A0EB82E-F878-492a-951E-AE000918C4A6 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgInitialize : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// Initialize(
|
|
// [ in ] IUnknown * punkCallbackIn,
|
|
// [ in ] LCID lcidIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Register callbacks, locale id, etc.
|
|
//
|
|
// Parameters:
|
|
// punkCallbackIn
|
|
// The callback interface.
|
|
//
|
|
// lcidIn
|
|
// The locale ID to be used for strings that are passed.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The initialization succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Initialize(
|
|
[ in ] IUnknown * punkCallbackIn,
|
|
[ in ] LCID lcidIn
|
|
);
|
|
|
|
}; //*** interface IClusCfgInitialize
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgCallback
|
|
//
|
|
// Description:
|
|
// This interface is used to callback to the client to indicate
|
|
// status or progess (or both) about a task being completed on the
|
|
// server.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 238DCA63-E2EF-4f32-A24D-ACBF975BE842 ),
|
|
async_uuid( EBCE8945-AC69-4b3a-865D-E2D4EB33E41B ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgCallback : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SendStatusReport(
|
|
// [ in ] LPCWSTR pcszNodeNameIn,
|
|
// [ in ] CLSID clsidTaskMajorIn
|
|
// [ in ] CLSID clsidTaskMinorIn,
|
|
// [ in ] ULONG ulMinIn,
|
|
// [ in ] ULONG ulMaxIn,
|
|
// [ in ] ULONG ulCurrentIn,
|
|
// [ in ] HRESULT hrStatusIn,
|
|
// [ in ] LPCWSTR pcszDescriptionIn,
|
|
// [ in ] FILETIME * pftTimeIn,
|
|
// [ in ] LPCWSTR pcszReferenceIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Send a status report back to the user interface/script.
|
|
//
|
|
// Parameters:
|
|
// pcszNodeNameIn
|
|
// The name of the node (server) that sent the report.
|
|
//
|
|
// clsidTaskMajorIn
|
|
// CLSID of the major task item to give status about. For the
|
|
// wizard, this indicates which node in the tree view control
|
|
// to publish this status message under. If clsidTaskMajorIn
|
|
// equals TASKID_Major_Client_Log, TASKID_Major_Server_Log, or
|
|
// TASKID_Major_Client_And_Server_Log, only a log entry will be
|
|
// made.
|
|
//
|
|
// clsidTaskMinorIn
|
|
// CLSID of the minor task to give status about. These should be
|
|
// unique to each sub-task and message.
|
|
//
|
|
// ulMinIn
|
|
// The min value of progress.
|
|
//
|
|
// ulMaxIn
|
|
// The max value of progress.
|
|
//
|
|
// ulCurrentIn
|
|
// The current value of progress.
|
|
//
|
|
// hrStatusIn
|
|
// The current status.
|
|
//
|
|
// pcszDescriptionIn
|
|
// The description of the status. Can be NULL to indicate that nothing
|
|
// needs to be passed.
|
|
//
|
|
// pftTimeIn
|
|
// UTC time of when this event was generated.
|
|
//
|
|
// pcszReference
|
|
// Optional reference data, additional context, URL, etc. that
|
|
// might better help explain the problem is this is an error
|
|
// report.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SendStatusReport(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNodeNameIn,
|
|
[ in ] CLSID clsidTaskMajorIn,
|
|
[ in ] CLSID clsidTaskMinorIn,
|
|
[ in ] ULONG ulMinIn,
|
|
[ in ] ULONG ulMaxIn,
|
|
[ in ] ULONG ulCurrentIn,
|
|
[ in ] HRESULT hrStatusIn,
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszDescriptionIn,
|
|
[ in ] FILETIME * pftTimeIn,
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszReferenceIn
|
|
);
|
|
|
|
}; //*** interface IClusCfgCallback
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgCredentials
|
|
//
|
|
// Description:
|
|
// The IClusCfgCredentials interface provides the functions
|
|
// for getting and setting user credentials.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 54AA9406-A409-4b49-B314-5F0A0CE4C88E ),
|
|
async_uuid( 54AA9406-A409-4b49-B314-5F0A0CE4C88F ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgCredentials : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// SetCredentials(
|
|
// [ in ] LPCWSTR pcszUserIn,
|
|
// [ in ] LPCWSTR pcszDomainIn,
|
|
// [ in ] LPCWSTR pcszPasswordIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Set the credentials.
|
|
//
|
|
// Parameters:
|
|
// pcszUserIn
|
|
// The user name.
|
|
//
|
|
// pcszDomainIn
|
|
// The domain name.
|
|
//
|
|
// pcszPasswordIn
|
|
// The user's password.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetCredentials(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszUserIn
|
|
, [ in, pointer_default( unique ) ] LPCWSTR pcszDomainIn
|
|
, [ in, pointer_default( unique ) ] LPCWSTR pcszPasswordIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// GetCredentials(
|
|
// [ out ] BSTR * pbstrUserOut,
|
|
// [ out ] BTSR * pbstrDomainOut,
|
|
// [ out ] BTSR * pbstrPasswordOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Get the credentials.
|
|
//
|
|
// Parameters:
|
|
// pbstrUserOut
|
|
// Catches the user name.
|
|
//
|
|
// pbstrDomainOut
|
|
// Catches the domain name.
|
|
//
|
|
// pbstrPasswordOut
|
|
// Catches the user's password.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetCredentials(
|
|
[ out ] BSTR * pbstrUserOut
|
|
, [ out ] BSTR * pbstrDomainOut
|
|
, [ out ] BSTR * pbstrPasswordOut
|
|
);
|
|
|
|
}; //*** interface IClusCfgCredentials
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgCapabilities
|
|
//
|
|
// Description:
|
|
// The IClusCfgCapabilities interface provides the functions
|
|
// for determining the capabilities of a node.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( D94AB253-36C7-41c1-B52E-26B451975C8D ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgCapabilities : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// CanNodeBeClustered( void )
|
|
//
|
|
// Description:
|
|
// Determines if a node can be clustered.
|
|
//
|
|
// Parameters:
|
|
// None.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded. The node can be clustered.
|
|
//
|
|
// S_FALSE
|
|
// The call succeeded. The node can not be clustered.
|
|
//
|
|
// E_NOTIMPL
|
|
// The call failed. This is treated as a "don't care."
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
CanNodeBeClustered( void );
|
|
|
|
}; //*** interface IClusCfgCapabilities
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgManagedResourceCfg
|
|
//
|
|
// Description:
|
|
// TODO: gpease 06-JUN-2000
|
|
// Write a description.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 60300A0F-77E1-440c-BD94-6BFB0DBFDB3A ),
|
|
local,
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgManagedResourceCfg : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgManagedResourceCfg::PreCreate(
|
|
// IUnknown * punkServicesIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method is called by the post configuration manager to
|
|
// determine the requirements of the resource. Querying the
|
|
// punkServicesIn allows the managed resource to use services
|
|
// provided by the manager.
|
|
//
|
|
// Arguments:
|
|
// punkServicesIn
|
|
// The resource should QI this interface for services provided
|
|
// by the post configuration manager and to set its dependencies.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
PreCreate( [ in ] IUnknown * punkServicesIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgManagedResourceCfg::Create(
|
|
// IUnknown * punkServicesIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method is called by the post configuration manager to
|
|
// have the resource create an instance of itself. Querying the
|
|
// punkServicesIn allows the managed resource to use services
|
|
// provided by the manager.
|
|
//
|
|
// Arguments:
|
|
// punkServicesIn
|
|
// The resource should QI this interface for services provided
|
|
// by the post configuration manager and to create itself.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Create( [ in ] IUnknown * punkServicesIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgManagedResourceCfg::PostCreate(
|
|
// IUnknown * punkServicesIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method is called by the post configuration manager to allow
|
|
// resources to perform any post-creation configuration that may be
|
|
// needed. At this point the cluster is fully configured. Querying
|
|
// the punkServicesIn allows the managed resource to use services
|
|
// provided by the manager.
|
|
//
|
|
// Arguments:
|
|
// punkServicesIn
|
|
// The resource should QI this interface for services provided
|
|
// by the post configuration manager.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
PostCreate( [ in ] IUnknown * punkServicesIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgManagedResourceCfg::Evict(
|
|
// IUnknown * punkServicesIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method is called by the post configuration manager to alert
|
|
// the resource that this node was evicted from the cluster. The
|
|
// resource should do whatever cleanup it needs to do revert to a
|
|
// non-clustered state. Querying the punkServicesIn allows the
|
|
// managed resource to uses services provided by the post
|
|
// configuration manager.
|
|
//
|
|
// Arguments:
|
|
// punkServicesIn
|
|
// The resource should QI this interface for services provided
|
|
// by the post configuration manager.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed. Errors are ignored and do not prevent a node
|
|
// from being evicted.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Evict( [ in ] IUnknown * punkServicesIn );
|
|
|
|
}; //*** interface IClusCfgManagedResourceCfg
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgResourcePreCreate
|
|
//
|
|
// Description:
|
|
// TODO: gpease 06-JUN-2000
|
|
// Write a description.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 4240F6A1-9D49-427e-8F3D-09384E1F59E4 ),
|
|
local,
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgResourcePreCreate : IUnknown
|
|
{
|
|
typedef
|
|
[
|
|
uuid( 1DAF9692-6662-43b1-AD45-D50F7849B0CD ),
|
|
helpstring("Resource dependency flags")
|
|
]
|
|
enum EDependencyFlags {
|
|
[helpstring("Unknown access")] dfUNKNOWN = 0,
|
|
[helpstring("Shared access resource")] dfSHARED = 1,
|
|
[helpstring("Exclusive access resource")] dfEXCLUSIVE = 2,
|
|
} EDependencyFlags;
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourcePreCreate::SetDependency(
|
|
// LPCLSID pclsidDepResTypeIn,
|
|
// EDependencyFlags dflagIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Informs the post configuration manager that a resource has a
|
|
// dependency on another type of resource and if the resource needs
|
|
// the resource for shared access or exclusive access.
|
|
//
|
|
// Arguments:
|
|
// pclsidDepResTypeIn
|
|
// The CLSID of the type of resource that a resource is
|
|
// requesting a dependency on. These are documented in the SDK
|
|
// or by the 3rd party resource.
|
|
//
|
|
// dfIn
|
|
// Flags to modify the dependency relationship. The following
|
|
// are defined flags:
|
|
//
|
|
// dfSHARED - the dependent resource can be shared.
|
|
// dfEXCLUSIVE - the dependent resource can not be shared.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetDependency(
|
|
[ in ] LPCLSID pclsidDepResTypeIn
|
|
, [ in ] DWORD dfIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourcePreCreate::GetType(
|
|
// CLSID * pclsidIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// A managed resource MUST call this to indicate its resource type.
|
|
// Failure to call this during PreCreate will result in your
|
|
// resource not being created.
|
|
//
|
|
// Arguments:
|
|
// pclsidIn
|
|
// Pointer to the GUID of the resource type.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetType( [ in ] CLSID * pclsidIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourcePreCreate::SetClassType(
|
|
// CLSID * pclsidIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// A managed resource sets this to indicate that its resource type
|
|
// can be considered to be of a class of resource. You may call this
|
|
// multiple times to indicate all the classes you belong to.
|
|
//
|
|
// Arguments:
|
|
// pclsidIn
|
|
// Pointer to the GUID of the resource class type.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetClassType( [ in ] CLSID * pclsidIn );
|
|
|
|
}; //*** interface IClusCfgResourcePreCreate
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgResourceCreate
|
|
//
|
|
// Description:
|
|
// TODO: gpease 06-JUN-2000
|
|
// Write a description.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 0647B41A-C777-443c-9432-02CCCF4FF443 ),
|
|
local,
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgResourceCreate : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyBinary(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const DWORD cbSizeIn
|
|
// , [ in ] const BYTE * pbyteIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyBinary(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const DWORD cbSizeIn
|
|
, [ in ] const BYTE * pbyteIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyDWORD(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const DWORD dwDWORDIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyDWORD(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const DWORD dwDWORDIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyString(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] LPCWSTR pcszStringIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyString(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in, pointer_default( unique ) ] LPCWSTR pcszStringIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyExpandString(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] LPCWSTR pcszStringIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyExpandString(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in, pointer_default( unique ) ] LPCWSTR pcszStringIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyMultiString(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const DWORD cbMultiStringIn
|
|
// , [ in ] LPCWSTR pcszMultiStringIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyMultiString(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const DWORD cbMultiStringIn
|
|
, [ in, pointer_default( unique ) ] LPCWSTR pcszMultiStringIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyUnsignedLargeInt(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const ULARGE_INTEGER ulIntIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyUnsignedLargeInt(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const ULARGE_INTEGER ulIntIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyLong(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const LONG lLongIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyLong(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const LONG lLongIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertySecurityDescriptor(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const SECURITY_DESCRIPTOR * pcsdIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertySecurityDescriptor(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const SECURITY_DESCRIPTOR * pcsdIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SetPropertyLargeInt(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// , [ in ] const LARGE_INTEGER lIntIn
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetPropertyLargeInt(
|
|
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
|
|
, [ in ] const LARGE_INTEGER lIntIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SendResourceControl(
|
|
// [ in ] DWORD dwControlCode
|
|
// , [ in ] LPVOID lpInBuffer
|
|
// , [ in ] DWORD cbInBufferSize
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SendResourceControl(
|
|
[ in ] DWORD dwControlCodeIn
|
|
, [ in ] LPVOID lpBufferIn
|
|
, [ in ] DWORD cbBufferSizeIn
|
|
);
|
|
|
|
}; //*** interface IClusCfgResourceCreate
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgResourcePostCreate
|
|
//
|
|
// Description:
|
|
// TODO: gpease 06-JUN-2000
|
|
// Write a description.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 72A9BF54-13B6-451f-910D-6913EBF025AB ),
|
|
local,
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgResourcePostCreate : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourcePostCreate::ChangeName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Changes the name of the resource.
|
|
//
|
|
// Arguments:
|
|
// pcszNameIn
|
|
// The name to assign the group.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
ChangeName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceCreate::SendResourceControl(
|
|
// [ in ] DWORD dwControlCode
|
|
// , [ in ] LPVOID lpInBuffer
|
|
// , [ in ] DWORD cbInBufferSize
|
|
// , [ in ] LPVOID lpOutBuffer
|
|
// , [ in ] DWORD cbOutBufferSize
|
|
// , [ out ] LPDWORD lpcbBytesReturned
|
|
// )
|
|
//
|
|
// Description:
|
|
//
|
|
// Arguments:
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SendResourceControl(
|
|
[ in ] DWORD dwControlCodeIn
|
|
, [ in ] LPVOID lpBufferIn
|
|
, [ in ] DWORD cbBufferSizeIn
|
|
, [ in ] LPVOID lBufferInout
|
|
, [ in ] DWORD cbOutBufferSizeIn
|
|
, [ out ] LPDWORD lpcbBytesReturnedOut
|
|
);
|
|
|
|
}; //*** interface IClusCfgResourcePostCreate
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgGroupCfg
|
|
//
|
|
// Description:
|
|
// TODO: gpease 06-JUN-2000
|
|
// Write a description.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( DCB6D3D2-A55F-49e5-A64A-0CCFEB01ED3A ),
|
|
local,
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgGroupCfg : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgGroupCfg::SetName(
|
|
// [ in ] LPCWSTR pcszNameIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// Changes the name of the group in which the resource was created.
|
|
// Note that the last resource to set the name wins. The ordering
|
|
// of the last resource is the resource that doesn't have anything
|
|
// depending on it.
|
|
//
|
|
// Arguments:
|
|
// pcszNameIn
|
|
// The name to assign the group.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SetName( [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgGroupCfg::GetName(
|
|
// BSTR * pbstrNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Retrieves the name of the group in which the resource was created.
|
|
// Note that the last resource to set the name wins. The ordering
|
|
// of the last resource is the resource that doesn't have anything
|
|
// depending on it. Do not cache this value as the name may change
|
|
// after control has been returned to the manager.
|
|
//
|
|
// Arguments:
|
|
// pbstrNameOut
|
|
// The name to assign the group.
|
|
//
|
|
// Return Value:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// HRESULT_FROM_WIN32( ERROR_MORE_DATA )
|
|
// The buffer size specified is too small.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetName( [ out ] BSTR * pbstrNameOut );
|
|
|
|
}; //*** interface IClusCfgGroupCfg
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgMemberSetChangeListener
|
|
//
|
|
// Description:
|
|
// This interface is implemented by an component that wishes to be notified
|
|
// of when the local computer becomes part of a cluster or when it leaves
|
|
// a cluster - in other words, when the member set of a cluster changes
|
|
// as a result of a cluster configuration operation on the local computer.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 2B64534F-2643-4ABC-A4E5-824D881B7582 ),
|
|
async_uuid( 2B645350-2643-4ABC-A4E5-824D881B7582 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgMemberSetChangeListener : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgMemberSetChangeListener::Notify(
|
|
// [ in ] IUnknown * punkClusterInfoIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method is called to notify a component that this computer has
|
|
// either joined or left a cluster. During this call, a component typically
|
|
// performs operations that are required to switch it from the "clustered"
|
|
// to "non-clustered" mode or vice versa. For example, an application
|
|
// that implements this interface could use this function to create
|
|
// its resource type when the local computer joins a cluster.
|
|
//
|
|
// If the node has just become part of a cluster, the cluster
|
|
// service is guaranteed to be running when this method is called.
|
|
// Querying the punkClusterInfoIn allows the listener to get more
|
|
// information about the event that caused the listener to be notified.
|
|
//
|
|
// Arguments:
|
|
// punkClusterInfoIn
|
|
// The resource should QI this interface for services provided
|
|
// by the caller of this function. Typically, the component that
|
|
// this punk refers to also implements the IClusCfgClusterInfo
|
|
// interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Notify( [ in ] IUnknown * punkClusterInfoIn );
|
|
|
|
}; //*** interface IClusCfgMemberSetChangeListener
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgResourceTypeInfo
|
|
//
|
|
// Description:
|
|
// This interface is implemented by components that wish to configure
|
|
// ( create, delete, etc. ) resource types during cluster configuration
|
|
// ( cluster formation, node addition, node eviction, etc. ).
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( C649A281-C847-4F5C-9841-D2F73B5AA71D ),
|
|
async_uuid( C649A282-C847-4F5C-9841-D2F73B5AA71D ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgResourceTypeInfo : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceTypeInfo::CommitChanges(
|
|
// [ in ] IUnknown * punkClusterInfoIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// A component that wishes to participate in the configuration of
|
|
// cluster resource types should perform the configuration steps
|
|
// necessary for its resource type in this method.
|
|
//
|
|
// This method is called by the cluster configuration server when
|
|
// the local computer becomes part of a cluster. The cluster service
|
|
// is guaranteed to be running at this stage. This method is also
|
|
// called when the local computer is evicted from a cluster - the
|
|
// cluster service will not be running if this is the case.
|
|
//
|
|
// Typically, a component will create a resource type in this method
|
|
// during cluster formation and join and will perform any cleanup
|
|
// required during node evict.
|
|
//
|
|
// Arguments:
|
|
// punkClusterInfoIn
|
|
// The resource type should QI this interface for services provided
|
|
// by the caller of this function. Typically, the component that
|
|
// this punk refers to also implements the IClusCfgClusterInfo
|
|
// interface.
|
|
//
|
|
// punkResTypeServicesIn
|
|
// Pointer to the IUnknown interface of a component that provides
|
|
// methods that help configuring a resource type. For example,
|
|
// during a join or a form, this punk can be queried for the
|
|
// IClusCfgResourceTypeCreate interface, which provides methods
|
|
// for resource type creation.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
CommitChanges(
|
|
[ in ] IUnknown * punkClusterInfoIn,
|
|
[ in ] IUnknown * punkResTypeServicesIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceTypeInfo::GetTypeName(
|
|
// [ out ] BSTR * pbstrTypeNameOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Get the resource type name of this resource type.
|
|
//
|
|
// Arguments:
|
|
// pbstrTypeNameOut
|
|
// Pointer to the BSTR that holds the name of the resource type.
|
|
// This BSTR has to be freed by the caller using the function
|
|
// SysFreeString().
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded.
|
|
//
|
|
// E_OUTOFMEMORY
|
|
// Out of memory.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetTypeName( [ out ] BSTR * pbstrTypeNameOut );
|
|
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceTypeInfo::GetTypeGUID(
|
|
// [ out ] GUID * pguidGUIDOut
|
|
// )
|
|
//
|
|
// Description:
|
|
// Get the globally unique identifier of this resource type.
|
|
//
|
|
// Arguments:
|
|
// pguidGUIDOut
|
|
// Pointer to the GUID object which will receive the GUID of this
|
|
// resource type.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// The call succeeded and the *pguidGUIDOut contains the type GUID.
|
|
//
|
|
// S_FALSE
|
|
// The call succeeded but this resource type does not have a GUID.
|
|
// The value of *pguidGUIDOut is undefined after this call.
|
|
//
|
|
// other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
GetTypeGUID( [ out ] GUID * pguidGUIDOut );
|
|
|
|
}; //*** interface IClusCfgResourceTypeInfo
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgResourceTypeCreate
|
|
//
|
|
// Description:
|
|
// This interface provides functions that help create a resource type
|
|
// during cluster configuration. A pointer to this interface is provided
|
|
// to components that participate in resource type configuration during
|
|
// cluster configuration.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 3AFCE3B8-5F3E-4DDF-A8F4-4B4FCBF28F8F ),
|
|
async_uuid( 3AFCE3B9-5F3E-4DDF-A8F4-4B4FCBF28F8F ),
|
|
pointer_default( unique )
|
|
]
|
|
interface IClusCfgResourceTypeCreate : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceTypeCreate::Create(
|
|
// [in, string ] const WCHAR * pcszResTypeNameIn,
|
|
// [in, string ] const WCHAR * pcszResTypeDisplayNameIn,
|
|
// [in, string ] const WCHAR * pcszResDllNameIn,
|
|
// [in] DWORD dwLooksAliveIntervalIn,
|
|
// [in] DWORD dwIsAliveIntervalIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method creates a cluster resource type.
|
|
//
|
|
// Arguments:
|
|
// pcszResTypeNameIn
|
|
// Name of the resource type
|
|
//
|
|
// pcszResTypeDisplayNameIn
|
|
// Display name of the resource type
|
|
//
|
|
// pcszResDllNameIn
|
|
// Name (with or without path information) of DLL of the resource type.
|
|
//
|
|
// dwLooksAliveIntervalIn
|
|
// Looks-alive interval for the resource type (in milliseconds).
|
|
//
|
|
// dwIsAliveIntervalIn
|
|
// Is-alive interval for the resource type (in milliseconds).
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Create(
|
|
[in, string ] const WCHAR * pcszResTypeNameIn,
|
|
[in, string ] const WCHAR * pcszResTypeDisplayNameIn,
|
|
[in, string ] const WCHAR * pcszResDllNameIn,
|
|
[in] DWORD dwLooksAliveIntervalIn,
|
|
[in] DWORD dwIsAliveIntervalIn
|
|
);
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgResourceTypeCreate::RegisterAdminExtensions(
|
|
// [in, string ] const WCHAR * pcszResDllNameIn,
|
|
// [in] ULONG cExtClsidCountIn,
|
|
// [in, size_is( cExtClsidCountIn ) ] const CLSID * rgclsidExtClsidsIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method registers the cluster administrator extensions for
|
|
// a resource type.
|
|
//
|
|
// Arguments:
|
|
// pcszResTypeNameIn
|
|
// Name of the resource type against for the extensions are to be
|
|
// registered.
|
|
//
|
|
// cExtClsidCountIn
|
|
// Number of extension class ids in the next parameter.
|
|
//
|
|
// rgclsidExtClsidsIn
|
|
// Pointer to an array of class ids of cluster administrator extensions.
|
|
// This can be NULL if cExtClsidCountIn is 0.
|
|
//
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// other HRESULTs.
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
RegisterAdminExtensions(
|
|
[in, string ] const WCHAR * pcszResTypeNameIn,
|
|
[in] ULONG cExtClsidCountIn,
|
|
[in, size_is( cExtClsidCountIn ) ] const CLSID * rgclsidExtClsidsIn
|
|
);
|
|
|
|
}; //*** interface IClusCfgResourceTypeCreate
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgEvictCleanup
|
|
//
|
|
// Description:
|
|
// This interface can be used to cleanup a node that has been evicted from
|
|
// a cluster.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( 6FE3E361-D373-4C5F-A0AF-1DFE8493C655 ),
|
|
async_uuid( 6FE3E362-D373-4C5F-A0AF-1DFE8493C655 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface
|
|
IClusCfgEvictCleanup : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgEvictCleanup::CleanupLocal( [ in ] DWORD dwDelayIn )
|
|
//
|
|
// Description:
|
|
// This method performs the clean up actions on the local node after
|
|
// it has been evicted from a cluster, so that the node can go back
|
|
// to its "pre-clustered" state.
|
|
//
|
|
// Arguments:
|
|
// DWORD dwDelayIn
|
|
// Number of milliseconds that this method will wait before starting
|
|
// cleanup. If some other process cleans up this node while this thread
|
|
// is waiting, the wait is terminated. If this value is zero, this method
|
|
// will attempt to clean up this node immediately.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// Other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
CleanupLocalNode( [ in ] DWORD dwDelayIn );
|
|
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgEvictCleanup::CleanupRemoteNode(
|
|
// const WCHAR * pcszEvicteeNodeNameIn
|
|
// , DWORD dwDelayIn
|
|
// )
|
|
//
|
|
// Description:
|
|
// This method performs the clean up actions on a remote node after
|
|
// it has been evicted from a cluster, so that the node can go back
|
|
// to its "pre-clustered" state.
|
|
//
|
|
// Arguments:
|
|
// const WCHAR * pcszEvictedNodeNameIn
|
|
// Name of the node that has just been evicted. This can be the
|
|
// NetBios name of the node, the fully qualified domain name or
|
|
// the node IP address.
|
|
//
|
|
// DWORD dwDelayIn
|
|
// Number of milliseconds that this method will wait before starting
|
|
// cleanup. If some other process cleans up this node while this thread
|
|
// is waiting, the wait is terminated. If this value is zero, this method
|
|
// will attempt to clean up this node immediately.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// Other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
CleanupRemoteNode(
|
|
[ in, string ] const WCHAR * pcszEvictedNodeNameIn
|
|
, [ in ] DWORD dwDelayIn
|
|
);
|
|
|
|
}; // interface IClusCfgEvictCleanup
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgStartupListener
|
|
//
|
|
// Description:
|
|
// This interface is implemented by a component that wishes to be notified
|
|
// when the cluster service has started.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( D282CAEF-2EDE-4ab9-A5D5-F7BDE3D23F0F ),
|
|
async_uuid( D282CAF0-2EDE-4ab9-A5D5-F7BDE3D23F10 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface
|
|
IClusCfgStartupListener : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgStartupListener::Notify( [ in ] IUnknown * punkIn )
|
|
//
|
|
// Description:
|
|
// This method is called to inform a component that the cluster service
|
|
// has started on the local node.
|
|
//
|
|
// Arguments:
|
|
// IUnknown * punkIn
|
|
// The component that implements this Punk may also provide services
|
|
// that are useful to the implementor of this method. For example,
|
|
// this component usually implements the IClusCfgResourceTypeCreate
|
|
// interface.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// Other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
Notify( [ in ] IUnknown * punkIn );
|
|
|
|
}; // interface IClusCfgStartupListener
|
|
|
|
|
|
//****************************************************************************
|
|
//++
|
|
//
|
|
// interface IClusCfgStartupNotify
|
|
//
|
|
// Description:
|
|
// This interface is implemented by a component that the cluster service
|
|
// instantiates. When the cluster service calls the only method on this
|
|
// interface, this component will enumerate the startup listeners and
|
|
// inform them that the cluster service has started on the local node.
|
|
//
|
|
//--
|
|
//****************************************************************************
|
|
[
|
|
object,
|
|
uuid( C2B0D069-6353-4EE1-B253-6B0D75DB2CD3 ),
|
|
async_uuid( C2B0D06A-6353-4EE1-B253-6B0D75DB2CD3 ),
|
|
pointer_default( unique )
|
|
]
|
|
interface
|
|
IClusCfgStartupNotify : IUnknown
|
|
{
|
|
//////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// STDMETHOD
|
|
// IClusCfgStartupNotify::SendNotifications( [ in ] IUnknown * punkIn )
|
|
//
|
|
// Description:
|
|
// This method is called by the Cluster Service to inform the implementor
|
|
// of this interface to send out notification of cluster service startup
|
|
// to interested listeners. If this method is being called for the first
|
|
// time, the method waits till the post configuration steps are complete
|
|
// before sending out the notifications.
|
|
//
|
|
// Arguments:
|
|
// None.
|
|
//
|
|
// Return Values:
|
|
// S_OK
|
|
// Success.
|
|
//
|
|
// Other HRESULTs
|
|
// The call failed.
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////
|
|
HRESULT
|
|
SendNotifications( void );
|
|
|
|
}; // interface IClusCfgStartupNotify
|