able/windows-nt
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
windows-nt/Source/XPSP1/NT/base/cluster/mgmt/cluscfg/inc/cluscfgclient.idl

2214 lines
57 KiB
Plaintext
Raw Normal View History

Add source files
2020-09-26 03:20:57 -05:00
//////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2000-2001 Microsoft Corporation
//
// Module Name:
// ClusCfgClient.idl
//
// Description:
// This file is the IDL file for the middler tier framework for the
// Cluster Configuration Wizard.
//
//////////////////////////////////////////////////////////////////////////////
// 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 ClusCfgClient.idl for more details." )
cpp_quote( "//" )
cpp_quote( "//////////////////////////////////////////////////////////////////////////////" )
//////////////////////////////////////////////////////////////////////////////
// Imported Files
//////////////////////////////////////////////////////////////////////////////
import "unknwn.idl";
import "objidl.idl";
import "ocidl.idl";
import "ClusCfgServer.idl";
//////////////////////////////////////////////////////////////////////////////
// Forward Declarations
//////////////////////////////////////////////////////////////////////////////
interface IClusCfgCallback;
interface INotifyUI;
interface IObjectManager;
interface INotificationManager;
interface ITaskManager;
interface IDoTask;
interface ITaskLoginDomain;
interface ITaskLoginDomainCallback;
interface ITaskGetDomains;
interface ITaskGetDomainsCallback;
interface ITaskAnalyzeCluster;
interface ITaskCommitClusterChanges;
interface ITaskVerifyIPAddress;
interface IStandardInfo;
interface IConnectionManager;
interface IConnectionInfo;
interface IGatherData;
interface IConfigurationConnection;
interface ITaskGatherNodeInfo;
interface ITaskGatherInformation;
interface IEnumNodes;
interface ITaskCompareAndPushInformation;
interface ITaskGatherClusterInfo;
interface IEnumCookies;
interface ITaskPollingCallback;
interface ILogManager;
interface ILogger;
//////////////////////////////////////////////////////////////////////////////
// Type Definitions
//////////////////////////////////////////////////////////////////////////////
typedef DWORD OBJECTCOOKIE;
//////////////////////////////////////////////////////////////////////////////
// Interface Definitions
//////////////////////////////////////////////////////////////////////////////
//****************************************************************************
//++
//
// interface INotifyUI
//
// Description:
// TODO: gpease 10-MAR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( E5E8D401-1A37-4fbf-880C-826CC89516FD ),
pointer_default( unique )
]
interface INotifyUI : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// INotifyUI::ObjectChanged(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Notifies the UI layer that the object "cookieIn"has changed. The
// object implementing this interface must marshall the data.
//
// Arguments:
// cookieIn
// Data Manager cookie to the object that changed.
//
// Return Value:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ObjectChanged(
[ in ] OBJECTCOOKIE cookieIn
);
}; //*** interace INotifyUI
//****************************************************************************
//++
//
// interface IDoTask
//
// Description:
// TODO: gpease 15-APR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 0230C9F8-EE7F-4307-98DB-726EBCAE55D6 ),
pointer_default( unique )
]
interface
IDoTask : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IDoTask::BeginTask( void )
//
// Description:
// Entry method for a task object.
//
// Arguments:
// None. You should describe a private interface to communicate
// parameters to your task.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
BeginTask( void );
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IDoTask::StopTask( void )
//
// Description:
// Entry method to stop/cancel and running task.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
StopTask( void );
}; //*** interface IDoTask
//****************************************************************************
//++
//
// interface INotificationManager
//
// Description:
// TODO: gpease 15-APR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 95531501-8782-4845-901D-312F36BA6C6E ),
pointer_default( unique )
]
interface
INotificationManager : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// INotificationManager::AddConnectionPoint(
// REFIID riidIn
// , IConnectionPoint * pcpIn
// )
//
// Description:
// Adds a connection point for the notification manager to manage
// for a particular interface. There can only be one registration
// for a particular interface.
//
// Arguments:
// riidIn
// The IID of the interface.
//
// pcpIn
// Interface to the connection point.
//
// Return Type:
// S_OK
// Success.
//
// CO_E_OBJISREG
// The interface for the connection point is already registered.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
AddConnectionPoint(
[ in ] REFIID riidIn
, [ in ] IConnectionPoint * pcpIn
);
}; //*** interface INotificationManager
//****************************************************************************
//++
//
// interface IConnectionManager
//
// Description:
// TODO: gpease 15-APR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( C0017768-1BF3-4352-8D6C-3A8C1D0FB477 ),
pointer_default( unique )
]
interface
IConnectionManager : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// GetConnectionToObject(
// OBJECTCOOKIE cookieIn
// , IUnknown ** ppunkOut
// )
//
// Description:
// Establishes a connection to the object referenced by "cookieIn."
//
// Arguments:
// cookieIn
// An object reference cookie from the Object Manager.
//
// ppunkOut
// Interface pointer to the object.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetConnectionToObject(
[ in ] OBJECTCOOKIE cookieIn
, [ out ] IUnknown ** ppunkOut
);
}; //*** interface IConnectionManager
//****************************************************************************
//++
//
// interface ITaskManager
//
// Description:
// TODO: gpease 15-APR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 16116694-DFC5-470b-AC12-46FBB01CEF10 ),
pointer_default( unique )
]
interface
ITaskManager : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskManager::CreateTask(
// REFIID clsidIn
// , IUnknown ** ppunkOut
// )
//
// Description:
// Submits a task to the Action Manager.
//
// Arguments:
// pTask
// Task to submit.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call fails.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
CreateTask(
[ in ] REFIID clsidIn
, [ out ] IUnknown ** ppunkOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskManager::SubmitTask(
// IDoTask * pTask
// )
//
// Description:
// Submits a task to the Action Manager.
//
// Arguments:
// pTask
// Task to submit.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call fails.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SubmitTask(
[ in ] IDoTask * pTask
);
}; //*** interface ITaskManager
//****************************************************************************
//++
//
// interface ITaskManager
//
// Description:
// TODO: gpease 15-APR-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( D51351DF-6394-4236-9783-65ED05631068 ),
pointer_default( unique )
]
interface
IObjectManager : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IObjectManager::FindObject(
// REFCLSID rclsidTypeIn
// , OBJECTCOOKIE cookieParentIn
// , LPCWSTR pcszNameIn
// , REFCLSID rclsidFormatIn
// , OBJECTCOOKIE * pcookieOut
// , LPUNKNOWN * ppunkOut
// )
//
// Description:
// Looks up and retrieves information about an object that has the
// type "rclsidTypeIn" and has the name "pcszNameIn". It will return
// an object that contains data in the format specified by
// "rclsidFormatIn". It will also return "pcookieOut" that can be
// used to identify the object in future requests.
//
// Arguments:
// rclsidTypeIn
// The type of the object to find.
//
// cookieParentIn
// Cookie of the cluster. NULL looking for a cluster.
//
// pcszNameIn
// The name of the object to find.
//
// rclsidFormatIn
// The format of the data to retrieve about the object.
//
// pcookieOut
// A value that represents the object.
//
// ppunkOut
// The requested data. NULL in indicates no data returned.
//
// Return Values:
// S_OK
// Success.
//
// S_PENDING
// Data being retrieved; ask again later using the cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
FindObject(
[ in ] REFCLSID rclsidTypeIn
, [ in ] OBJECTCOOKIE cookieClusterIn
, [ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
, [ in ] REFCLSID rclsidFormatIn
, [ out ] OBJECTCOOKIE * pcookieOut
, [ out ] LPUNKNOWN * ppunkOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IObjectManager::GetObject(
// REFCLSID rclsidFormatIn
// , OBJECTCOOKIE cookieIn
// , LPUNKNOWN * ppunkOut
// )
//
// Description:
// Lookups and retrieves information about the object using "cookieIn"
// as a reference. It will return an object that contains data in the
// format specified by "rclsidFormatIn".
//
// Arguments:
// rclsidFormatIn
// The format of the data to retrieve about the object.
//
// pcookieIn
// The value of the object to retrieve data from.
//
// ppunkOut
// The requested data. NULL in indicates no data returned.
//
// Return Values:
// S_OK
// Success.
//
// S_PENDING
// Data being retrieved; ask again later using the cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetObject(
[ in ] REFCLSID rclsidFormatIn
, [ in ] OBJECTCOOKIE cookieIn
, [ out ] LPUNKNOWN * ppunkOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IObjectManager::RemoveObject(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Removes an object from the object cache and requests deletion all
// existing data format objects. This will also remove all children
// of the object (if any).
//
// Arguments:
// cookieIn
// The cookie of the object to be removed.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
RemoveObject(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IObjectManager::SetObjectStatus(
// OBJECTCOOKIE cookieIn
// , HRESULT hrIn
// )
//
// Description:
// Sets the status on an object.
//
// Arguments:
// cookieIn
// The cookie of the object.
//
// hrIn
// Status to set.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetObjectStatus(
[ in ] OBJECTCOOKIE cookieIn
, [ in ] HRESULT hrIn
);
}; //*** interface IObjectManager
//
// Task Interfaces
//
//****************************************************************************
//++
//
// interface ITaskLoginDomain
//
// Description:
// TODO: gpease 15-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 76AD8E51-53C3-4347-895D-6C30F4139374 ),
pointer_default( unique )
]
interface
ITaskLoginDomain : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskLoginDomain::SetCallback(
// ITaskLoginDomainCallback * punkIn
// )
//
// Description:
// Sets the callback interface for the task to inform the caller
// of the status of the login.
//
// Arguments:
// punkIn
// The ITaskLoginDomainCallback interface to inform caller of
// statuc.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCallback(
[ in ] ITaskLoginDomainCallback * punkIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskLoginDomain::SetDomain(
// LPCWSTR pcszDomainIn
// )
//
// Description:
// Sets the domain to attempt to login into.
//
// Arguments:
// pcszDomainIn
// Name of the domain to be logged into.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetDomain(
[ in, pointer_default( unique ) ] LPCWSTR pcszDomainIn
);
}; //*** interface ITaskLoginDomain
//****************************************************************************
//++
//
// interface ITaskLoginDomainCallback
//
// Description:
// TODO: gpease 15-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( EFAF3C43-7A8F-469b-B8BB-C80C5747CE05 ),
pointer_default( unique )
]
interface
ITaskLoginDomainCallback : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskLoginDomainCallback::ReceiveLoginResult(
// HRESULT hrIn
// )
//
// Description:
// Callback used to tell the invoker of TaskLoginDomain the results
// of the login attempt. All Win32 errors will be mapped to HRESULTs
// via HRESULT_FROM_WIN32.
//
// Arguments:
// hrIn
// The HRESULT result code of the login attempt.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ReceiveLoginResult(
[ in ] HRESULT hrIn
);
}; //*** interface ITaskLoginDomainCallback
//****************************************************************************
//++
//
// interface ITaskGetDomains
//
// Description:
// TODO: gpease 15-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( DFCB4ACD-C4DB-4db4-8EBB-1DD07A9D5B82 ),
pointer_default( unique )
]
interface
ITaskGetDomains : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGetDomains::SetCallback(
// ITaskGetDomainsCallback * pResultsCallbackIn
// )
//
// Description:
// Stores the ITaskGetDomainsCallback that will be used to send
// status and names for this task.
//
// Arguments:
// pResultsCallbackIn
// The ITaskGetDomainsCallback interface of the object that will
// receive the status information as well as the names that are
// enumerated.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCallback(
[ in ] ITaskGetDomainsCallback * pResultsCallbackIn
);
}; // *** interface ITaskGetDomains
//****************************************************************************
//++
//
// interface ITaskGetDomainsCallback
//
// Description:
// TODO: gpease 15-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 85402E44-6834-41df-8590-01827D124E1B ),
pointer_default( unique )
]
interface
ITaskGetDomainsCallback : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGetDomainsCallback::ReceiveDomainResult(
// HRESULT hrIn
// )
//
// Description:
// Callback used to tell the invoker of TaskGetDomains the results
// of the enumeration. This will be only called if there is a
// problem.
//
// Arguments:
// hrIn
// The HRESULT result code of the login attempt.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed - this will abort the enumeration.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ReceiveDomainResult( [ in ] HRESULT hrIn );
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGetDomainsCallback::ReceiveDomainName(
// LPCWSTR pcszDomainIn
// )
//
// Description:
// This method will be called by the TaskGetDomains to send an
// enumerated name back to the UI layer.
//
// Arguments:
// pcszDomainIn
// The next enumerated domain name.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs
// The call failed - this will abort the enumeration.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ReceiveDomainName(
[ in, pointer_default( unique ) ] LPCWSTR pcszDomainIn
);
}; //*** interface ITaskGetDomainsCallback
//****************************************************************************
//++
//
// interface ITaskAnalyzeCluster
//
// Description:
// TODO: gpease 18-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 795737A1-E13A-45eb-8DFD-8185C4B7AD4E ),
pointer_default( unique )
]
interface
ITaskAnalyzeCluster : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskAnalyzeCluster::SetJoiningMode( void )
//
// Description:
// Changes this task to joining mode.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetJoiningMode( void );
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskAnalyzeCluster::SetCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie that will be used to send the notification that the
// task has been completed.
//
// Arguments:
// cookieIn
// A cookie that will be sent as notification that the task is done.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskAnalyzeCluster::SetClusterCookie(
// OBJECTCOOKIE cookieClusterIn
// )
//
// Description:
// Stores the cookie of the cluster configuration object.
//
// Arguments:
// cookieIn
// The cookie of the cluster to configure.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetClusterCookie(
[ in ] OBJECTCOOKIE cookieClusterIn
);
}; //*** interface ITaskAnalyzeCluster
//****************************************************************************
//++
//
// interface ITaskCommitClusterChanges
//
// Description:
// TODO: gpease 18-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 1BF12DDE-F8B0-49b1-A458-6747DB788A47 ),
pointer_default( unique )
]
interface
ITaskCommitClusterChanges : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskCommitClusterChanges::SetCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie that will be used to send the notification that the
// task has been completed.
//
// Arguments:
// cookieIn
// A cookie that will be sent as notification that the task is done.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskCommitClusterChanges::SetClusterCookie(
// OBJECTCOOKIE cookieClusterIn
// )
//
// Description:
// Stores the cookie of the cluster configuration object.
//
// Arguments:
// cookieIn
// The cookie of the cluster to configure.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetClusterCookie(
[ in ] OBJECTCOOKIE cookieClusterIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskCommitClusterChanges::SetJoining( void )
//
// Description:
// Sets the task into joining mode.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetJoining( void );
}; //*** interface ITaskCommitClusterChanges
//****************************************************************************
//++
//
// interface IStandardInfo
//
// Description:
// TODO: gpease 18-MAY-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( F1D9C1A5-9589-40dd-B63D-9BB0B38A1022 ),
pointer_default( unique )
]
interface
IStandardInfo : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::GetType(
// CLSID * pclsidTypeOut
// )
//
// Description:
// Retrieves the type of object.
//
// Arguments:
// pclsidTypeOut
// The CLSID representing the type.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetType(
[ out ] CLSID * pclsidTypeOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::GetName(
// BSTR * pbstrNameOut
// )
//
// Description:
// Retrieve the object's name.
//
// Arguments:
// pbstrNameOut
// The name of the object.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetName(
[ out ] BSTR * pbstrNameOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::SetName(
// LPCWSTR pcszNameIn
// )
//
// Description:
// Sets the object's name.
//
// Arguments:
// ppcszNameIn
// The name of the object.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetName(
[ in, pointer_default( unique ) ] LPCWSTR pcszNameIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::GetParent(
// OBJECTCOOKIE * pcookieOut
// )
//
// Description:
// Retrieve the parent object's cookie.
//
// Arguments:
// pcookieOut
// The cookie for the parent object.
//
// Return Type:
// S_OK
// Success.
//
// S_FALSE
// Success but there wasn't a cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetParent(
[ out ] OBJECTCOOKIE * pcookieOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::GetStatus(
// HRESULT * phrOut
// )
//
// Description:
// Retrieves the status of the object.
//
// Arguments:
// phrOut
// The last HRESULT received for the object.
//
// Return Type:
// S_OK
// Success.
//
// S_FALSE
// Success but there wasn't a cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetStatus(
[ out ] HRESULT * phrOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IStandardInfo::SetStatus(
// HRESULT hrIn
// )
//
// Description:
// Sets the status of the object.
//
// Arguments:
// hrIn
// Sets the last HRESULT for the object.
//
// Return Type:
// S_OK
// Success.
//
// S_FALSE
// Success but there wasn't a cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetStatus(
[ in ] HRESULT hrIn
);
}; //*** interface IStandardInfo
//****************************************************************************
//++
//
// interface ITaskVerifyIPAddress
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 0c95e1b1-0cff-4740-8abd-69912d105bd1 ),
pointer_default( unique )
]
interface
ITaskVerifyIPAddress : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskVerifyIPAddress::SetIPAddress(
// DWORD dwIPAddressIn
// )
//
// Description:
// Stores the IP Address to verify.
//
// Arguments:
// dwIPAddressIn
// Dotted-quad network-byte-order IP address to verify.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetIPAddress(
[ in ] DWORD dwIPAddressIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskVerifyIPAddress::SetCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie that will be used to send the notification that the
// task has been completed.
//
// Arguments:
// cookieIn
// A cookie that will be sent as notification that the task is done.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCookie(
[ in ] OBJECTCOOKIE cookieIn
);
}; //*** interface ITaskVerifyIPAddress
//****************************************************************************
//++
//
// interface IConfigurationConnection
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( DDAD8191-66C5-4a30-A4DF-CB6C216704CA ),
pointer_default( unique )
]
interface
IConfigurationConnection : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ConnectTo(
// LPVOID cookieIn
// )
//
// Description:
// Opens a connection a cluster "cookieIn".
//
// Arguments:
// cookieIn - cookie to the cluster to open.
//
// Return Type:
// S_OK - Success.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ConnectTo(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ConnectToObject(
// LPVOID cookieIn
// , REFIID riidIn
// , LPUNKNOWN * ppunkOut
// )
//
// Description:
// Opens a connection a cluster "cookieIn".
//
// Arguments:
// cookieIn - cookie to the cluster to open.
// riidIn - riid of the interface to get.
// ppunkOut - the interface to the object requested.
//
// Return Type:
// S_OK - Success.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
ConnectToObject(
[ in ] OBJECTCOOKIE cookieIn
, [ in ] REFIID riidIn
, [ in ] LPUNKNOWN * ppunkOut
);
}; //*** interface IConfigurationConnection
//****************************************************************************
//++
//
// interface IConnectionInfo
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 15182CE3-82D7-473f-92DE-706E2BCEA902 ),
pointer_default( unique )
]
interface
IConnectionInfo : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IConnectionInfo::GetConnection(
// IConfigurationConnection ** pccOut
// )
//
// Description:
// Retrieves the cookie for the connection object that is used to
// communicate with the object in question.
//
// Arguments:
// pccOut
// The interface to the connection object.
//
// Return Type:
// S_OK
// Success.
//
// S_FALSE
// Success but there wasn't a cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetConnection(
[ out ] IConfigurationConnection ** pccOut
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IConnectionInfo::SetConnection(
// IConfigurationConnection * pccIn
// )
//
// Description:
// Stores the cookie for the connection object that is used to
// communicate with the object in question.
//
// Arguments:
// pccIn
// The interface to the connection object.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetConnection(
[ in ] IConfigurationConnection * pccIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IConnectionInfo::GetParent(
// OBJECTCOOKIE * pcookieOut
// )
//
// Description:
// Retrieve the parent object's cookie.
//
// Arguments:
// pcookieOut
// The cookie for the parent object.
//
// Return Type:
// S_OK
// Success.
//
// S_FALSE
// Success but there wasn't a cookie.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
GetParent(
[ out ] OBJECTCOOKIE * pcookieOut
);
}; //*** interface IConnectionInfo
//****************************************************************************
//++
//
// interface IEnumCookies
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
// Documentation:
// See IEnumXXXX in MSDN.
//
//--
//****************************************************************************
[
object,
uuid( 5E3E482E-3C22-482c-B664-693051AD0A5D ),
pointer_default( unique )
]
interface
IEnumCookies : IUnknown
{
HRESULT
Next(
[ in ] ULONG celtIn
, [ out, size_is( celtIn ), length_is( *pceltFetchedOut ) ] OBJECTCOOKIE * rgcookieOut
, [ out ] ULONG * pceltFetchedOut
);
HRESULT
Skip(
[ in ] ULONG celtIn
);
HRESULT
Reset( void );
HRESULT
Clone(
[ out ] IEnumCookies ** ppenumOut
);
HRESULT
Count(
[ out, ref ] DWORD * pnCountOut
);
}; //*** interface IEnumCookies
//****************************************************************************
//++
//
// interface IEnumNodes
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
// Documentation:
// See IEnumXXXX in MSDN.
//
//--
//****************************************************************************
[
object,
uuid( C477E363-AF0A-4203-A604-45CD607DD710 ),
pointer_default( unique )
]
interface
IEnumNodes : IUnknown
{
HRESULT
Next(
[ in ] ULONG celtIn
, [ out, size_is( celtIn ), length_is( *pceltFetchedOut ) ] IClusCfgNodeInfo ** rgccniOut
, [ out ] ULONG * pceltFetchedOut
);
HRESULT
Skip(
[ in ] ULONG celtIn
);
HRESULT
Reset( void );
HRESULT
Clone(
[ out ] IEnumNodes ** ppenumOut
);
HRESULT
Count(
[ out, ref ] DWORD * pnCountOut
);
}; //*** interface IEnumNodes
//****************************************************************************
//++
//
// interface ITaskGatherClusterInfo
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( E167965C-C5D6-493c-A343-4C105C01DDE7 ),
pointer_default( unique )
]
interface
ITaskGatherClusterInfo : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherClusterInfo::SetCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to the Node to retrieve information about.
//
// Arguments:
// cookieIn
// The cookie of the Node to retrieve information about.
//
// Return Type:
// S_OK - Success.
// E_OUTOFMEMORY - Out of memory.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherClusterInfo::SetCompletionCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to signal when task is completed.
//
// Arguments:
// cookieIn
// The cookie to signal when the task is completed.
//
// Return Type:
// S_OK - Success.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCompletionCookie(
[ in ] OBJECTCOOKIE cookieIn
);
}; //*** interface ITaskGatherClusterInfo
//****************************************************************************
//++
//
// interface IGatherData
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 65318F4A-B63C-4e21-ADDC-BDCFB969E181 ),
pointer_default( unique )
]
interface
IGatherData : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// IGatherData::Gather(
// OBJECTCOOKIE cookieParentIn,
// IUnknown * punkIn
// )
//
// Description:
// An object representation gathers the information from the punk.
//
// Arguments:
// cookieParentIn
// The parent of the object.
//
// punkIn
// The interface that can be used to gather information.
//
// Return Type:
// S_OK
// Success.
//
// E_OUTOFMEMORY
// Out of memory.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
Gather(
[ in ] OBJECTCOOKIE cookieParentIn
, [ in ] IUnknown * punkIn
);
}; //*** interface IGatherData
//****************************************************************************
//++
//
// interface ITaskGatherNodeInfo
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( F19A2E01-2CB3-47b4-8F5D-B977176B45C8 ),
pointer_default( unique )
]
interface
ITaskGatherNodeInfo : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherNodeInfo::SetCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to the Node to retrieve information about.
//
// Arguments:
// cookieIn
// The cookie of the Node to retrieve information about.
//
// Return Type:
// S_OK - Success.
// E_OUTOFMEMORY - Out of memory.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherNodeInfo::SetCompletionCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to signal when the task is completed.
//
// Arguments:
// cookieIn
// The cookie to signal when the task is completed.
//
// Return Type:
// S_OK - Success.
// other HRESULTs.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCompletionCookie(
[ in ] OBJECTCOOKIE cookieIn
);
}; //*** interface ITaskGatherNodeInfo
//****************************************************************************
//++
//
// interface ITaskCompareAndPushInformation
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( D4F1C2AF-B370-49de-8768-4010B568636C ),
pointer_default( unique )
]
interface
ITaskCompareAndPushInformation : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskCompareAndPushInformation::SetNodeCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to the Node to retrieve information about.
//
// Arguments:
// cookieIn
// The cookie of the Node to retrieve information about.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetNodeCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskCompareAndPushInformation::SetCompletionCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to signal when the task is completed.
//
// Arguments:
// cookieIn
// The cookie to signal when the task is completed.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCompletionCookie(
[ in ] OBJECTCOOKIE cookieIn
);
}; //*** interface ITaskCompareAndPushInformation
//****************************************************************************
//++
//
// interface ITaskGatherInformation
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( B9AAF3F8-238E-4993-BA31-14859804F92C ),
pointer_default( unique )
]
interface
ITaskGatherInformation : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherInformation::SetNodeCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to the Node to retrieve information about.
//
// Arguments:
// cookieIn
// The cookie of the Node to retrieve information about.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetNodeCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherInformation::SetCompletionCookie(
// OBJECTCOOKIE cookieIn
// )
//
// Description:
// Stores the cookie to signal when the task is completed.
//
// Arguments:
// cookieIn
// The cookie to signal when the task is completed.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetCompletionCookie(
[ in ] OBJECTCOOKIE cookieIn
);
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskGatherInformation::SetJoining( void )
//
// Description:
// Sets the task to indicate that it going to be joining nodes.
//
// Arguments:
// None.
//
// Return Values:
// S_OK
// Success.
//
// other HRESULTs.
// The call
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetJoining( void );
}; //*** interface ITaskGatherInformation
//****************************************************************************
//++
//
// interface ITaskPollingCallback
//
// Description:
// TODO: gpease 14-JUL-2000
// Write a description.
//
//--
//****************************************************************************
[
object,
uuid( 49E92395-66AF-4add-A41E-43512CB519B3 ),
pointer_default( unique )
]
interface
ITaskPollingCallback : IDoTask
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ITaskPollingCallback::SetServerGITCookie(
// DWORD dwGITCookieIn
// )
//
// Description:
// Stores the GIT cookie to the IClusCfgServer interface of the
// server object.
//
// Arguments:
// dwGITCookieIn
// The GIT cookie to the server object used to obtain the
// polling callback interface.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
SetServerGITCookie(
[ in ] DWORD dwGITCookieIn
);
}; //*** interface ITaskPollingCallback
//****************************************************************************
//++
//
// interface IClusCfgAsyncEvictCleanup
//
// Description:
// This interface can be used to cleanup a node that has been evicted from
// a cluster. This interface can be used to cleanup both local and remote
// nodes. Note, you cannot use asynchronous COM with this interface, since
// it is an oleautomation interface.
//
//--
//****************************************************************************
[
object,
oleautomation,
uuid( 52C80B95-C1AD-4240-8D89-72E9FA84025E ),
pointer_default( unique )
]
interface
IClusCfgAsyncEvictCleanup : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// HRESULT
// CleanupNode(
// LPCWSTR pcszEvictedNodeNameIn
// , DWORD dwDelayIn
// , DWORD dwTimeoutIn
// )
//
// Routine Description:
// Cleanup a node that has been evicted.
//
// Arguments:
// LPCWSTR pcszEvictedNodeNameIn
// Name of the node on which cleanup is to be initiated. If this is NULL
// the local node is cleaned up.
//
// DWORD dwDelayIn
// Number of milliseconds that will elapse before cleanup is started
// on the target node. If some other process cleans up the target node while
// delay is in progress, the delay is terminated. If this value is zero,
// the node is cleaned up immediately.
//
// DWORD dwTimeoutIn
// Number of milliseconds that this method will wait for cleanup to complete.
// This timeout is independent of the delay above, so if dwDelayIn is greater
// than dwTimeoutIn, this method will most probably timeout. Once initiated,
// however, cleanup will run to completion - this method just may not wait for it
// to complete.
//
// Return Value:
// S_OK
// If the cleanup operations were successful
//
// RPC_S_CALLPENDING
// If cleanup is not complete in dwTimeoutIn milliseconds
//
// Other HRESULTS
// In case of error
//
//////////////////////////////////////////////////////////////////////////
HRESULT
CleanupNode(
[ in, pointer_default( unique ) ] LPCWSTR pcszEvictedNodeNameIn
, [ in ] DWORD dwDelayIn
, [ in ] DWORD dwTimeoutIn
);
}; //*** interface IClusCfgAsyncEvictCleanup
//****************************************************************************
//++
//
// interface ILogManager
//
// Description:
// Manage logging for all clients of the middle tier.
//
//--
//****************************************************************************
[
object,
uuid( 4759DC11-8DA0-4261-BBFB-EC321911D1C9 ),
pointer_default( unique )
]
interface
ILogManager : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ILogManager::StartLogging( void )
//
// Description:
// Starts logging IClusCfgCallback notifications to the log file.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
StartLogging( void );
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ILogManager::StopLogging( void )
//
// Description:
// Stops logging IClusCfgCallback notifications to the log file.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
StopLogging( void );
}; //*** interface ILogManager
//****************************************************************************
//++
//
// interface ILogger
//
// Description:
// Manage logging from multiple sources to the same log file.
//
//--
//****************************************************************************
[
object,
uuid( D9598418-304E-4f94-B6A1-E642FE95ED57 ),
pointer_default( unique )
]
interface
ILogger : IUnknown
{
//////////////////////////////////////////////////////////////////////////
//
// STDMETHOD
// ILogger::LogMsg(
// LPCWSTR pcszMsgIn
// )
//
// Description:
// Logs a message to the log file.
//
// Arguments:
// None.
//
// Return Type:
// S_OK
// Success.
//
// other HRESULTs.
// The call failed.
//
//////////////////////////////////////////////////////////////////////////
HRESULT
LogMsg(
[ in, pointer_default( unique ) ] LPCWSTR pcszMsgIn
);
}; //*** interface ILogger
Reference in a new issue Copy permalink