|
|
/*++
Copyright (c) 1996 Microsoft Corporation
Module Name:
NETDFS.IDL
Abstract:
Contains the Netr (Net Remote) RPC interface specification for the API associated with the Dfs Manager Service. This includes the following APIs:
NetDfsEnum
Also contains the RPC specific data structures for these API.
Author:
Milan Shah (milans) 08-Jan-1996
Environment:
User Mode - Win32 - MIDL
Revision History:
08-Jan-1996 Milans Created.
--*/
//// Interface Attributes//
[ uuid(4fc742e0-4a10-11cf-8273-00aa004ae673), version(3.0),#ifdef __midl ms_union,#endif // __midl pointer_default(unique)]
interface netdfs
{
import "import.idl";#include <lmcons.h>
//// Data structures used by the public Dfs interface//
typedef struct _DFS_INFO_1_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_1 Buffer;} DFS_INFO_1_CONTAINER, *LPDFS_INFO_1_CONTAINER;
typedef struct _DFS_INFO_2_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_2 Buffer;} DFS_INFO_2_CONTAINER, *LPDFS_INFO_2_CONTAINER;
typedef struct _DFS_INFO_3_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_3 Buffer;} DFS_INFO_3_CONTAINER, *LPDFS_INFO_3_CONTAINER;
typedef struct _DFS_INFO_4_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_4 Buffer;} DFS_INFO_4_CONTAINER, *LPDFS_INFO_4_CONTAINER;
typedef struct _DFS_INFO_200_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_200 Buffer;} DFS_INFO_200_CONTAINER, *LPDFS_INFO_200_CONTAINER;
typedef struct _DFS_INFO_300_CONTAINER { DWORD EntriesRead; [size_is(EntriesRead)] LPDFS_INFO_300 Buffer;} DFS_INFO_300_CONTAINER, *LPDFS_INFO_300_CONTAINER;
typedef struct _DFS_INFO_ENUM_STRUCT { DWORD Level; [switch_is(Level)] union { [case(1)] LPDFS_INFO_1_CONTAINER DfsInfo1Container; [case(2)] LPDFS_INFO_2_CONTAINER DfsInfo2Container; [case(3)] LPDFS_INFO_3_CONTAINER DfsInfo3Container; [case(4)] LPDFS_INFO_4_CONTAINER DfsInfo4Container; [case(200)] LPDFS_INFO_200_CONTAINER DfsInfo200Container; [case(300)] LPDFS_INFO_300_CONTAINER DfsInfo300Container; } DfsInfoContainer;} DFS_INFO_ENUM_STRUCT, *LPDFS_INFO_ENUM_STRUCT;
typedef [switch_type(unsigned long)] union _DFS_INFO_STRUCT { [case(1)] LPDFS_INFO_1 DfsInfo1; [case(2)] LPDFS_INFO_2 DfsInfo2; [case(3)] LPDFS_INFO_3 DfsInfo3; [case(4)] LPDFS_INFO_4 DfsInfo4; [case(100)] LPDFS_INFO_100 DfsInfo100; [case(101)] LPDFS_INFO_101 DfsInfo101; [case(102)] LPDFS_INFO_102 DfsInfo102; [default] ;} DFS_INFO_STRUCT, *LPDFS_INFO_STRUCT;
//// Data structures are used by the private Dfs Manager interface//
typedef struct _DFSM_ENTRY_ID { GUID idSubordinate; [string, unique] LPWSTR wszSubordinate;} DFSM_ENTRY_ID, *LPDFSM_ENTRY_ID;
typedef struct _DFSM_RELATION_INFO { DWORD cSubordinates; [size_is(cSubordinates)] DFSM_ENTRY_ID eid[];} DFSM_RELATION_INFO, *LPDFSM_RELATION_INFO;
typedef struct _DFSM_ROOT_LIST_ENTRY { [string, unique] LPWSTR ServerShare;} DFSM_ROOT_LIST_ENTRY, *PDFSM_ROOT_LIST_ENTRY, *LPDFSM_ROOT_LIST_ENTRY;
typedef struct _DFSM_ROOT_LIST { DWORD cEntries; [size_is(cEntries)] DFSM_ROOT_LIST_ENTRY Entry[];} DFSM_ROOT_LIST, *PDFSM_ROOT_LIST, *LPDFSM_ROOT_LIST;
//// The public Dfs interface methods//
DWORD NetrDfsManagerGetVersion();
NET_API_STATUS NetrDfsAdd( [in,string] LPWSTR DfsEntryPath, [in,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in,unique,string] LPWSTR Comment, [in] DWORD Flags);
NET_API_STATUS NetrDfsRemove( [in,string] LPWSTR DfsEntryPath, [in,unique,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName);
NET_API_STATUS NetrDfsSetInfo( [in,string] LPWSTR DfsEntryPath, [in,unique,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in] DWORD Level, [in,switch_is(Level)] LPDFS_INFO_STRUCT DfsInfo);
NET_API_STATUS NetrDfsGetInfo( [in,string] LPWSTR DfsEntryPath, [in,unique,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in] DWORD Level, [out,switch_is(Level)] LPDFS_INFO_STRUCT DfsInfo);
NET_API_STATUS NetrDfsEnum( [in] DWORD Level, [in] DWORD PrefMaxLen, [in,out,unique] LPDFS_INFO_ENUM_STRUCT DfsEnum, [in,out,unique] LPDWORD ResumeHandle);
NET_API_STATUS NetrDfsMove( [in,string] LPWSTR DfsEntryPath, [in,string] LPWSTR NewDfsEntryPath);
NET_API_STATUS NetrDfsRename( [in,string] LPWSTR Path, [in,string] LPWSTR NewPath);
//// The private Dfs Manager methods//
NET_API_STATUS NetrDfsManagerGetConfigInfo( [in, string] LPWSTR wszServer, [in, string] LPWSTR wszLocalVolumeEntryPath, [in] GUID idLocalVolume, [in, out, unique] LPDFSM_RELATION_INFO *ppRelationInfo);
NET_API_STATUS NetrDfsManagerSendSiteInfo( [in, string] LPWSTR wszServer, [in] LPDFS_SITELIST_INFO pSiteInfo);
//// Remote setup/teardown apis//
NET_API_STATUS NetrDfsAddFtRoot( [in,string] LPWSTR ServerName, [in,string] LPWSTR DcName, [in,string] LPWSTR RootShare, [in,string] LPWSTR FtDfsName, [in,string] LPWSTR Comment, [in,string] LPWSTR ConfigDN, [in] BOOLEAN NewFtDfs, [in] DWORD Flags, [in,out,unique] PDFSM_ROOT_LIST *ppRootList);
NET_API_STATUS NetrDfsRemoveFtRoot( [in,string] LPWSTR ServerName, [in,string] LPWSTR DcName, [in,string] LPWSTR RootShare, [in,string] LPWSTR FtDfsName, [in] DWORD Flags, [in,out,unique] PDFSM_ROOT_LIST *ppRootList);
NET_API_STATUS NetrDfsAddStdRoot( [in,string] LPWSTR ServerName, [in,string] LPWSTR RootShare, [in,string] LPWSTR Comment, [in] DWORD Flags);
NET_API_STATUS NetrDfsRemoveStdRoot( [in,string] LPWSTR ServerName, [in,string] LPWSTR RootShare, [in] DWORD Flags);
// Reinitialize the Dfs Manager//
NET_API_STATUS NetrDfsManagerInitialize( [in,string] LPWSTR ServerName, [in] DWORD Flags);
//// Create a root with the share offline//
NET_API_STATUS NetrDfsAddStdRootForced( [in,string] LPWSTR ServerName, [in,string] LPWSTR RootShare, [in,string] LPWSTR Comment, [in,string] LPWSTR Share);
//// Api's for setting up an FtDfs root//
NET_API_STATUS NetrDfsGetDcAddress( [in,string] LPWSTR ServerName, [in,out,string] LPWSTR *DcName, [in,out] BOOLEAN *IsRoot, [in,out] ULONG *Timeout);
//// Api to direct an FtDfs root server to a specific DC//
NET_API_STATUS NetrDfsSetDcAddress( [in,string] LPWSTR ServerName, [in,string] LPWSTR DcName, [in] DWORD Timeout, [in] DWORD Flags);
//// Api to tell a DC to flush an FtDfs entry from its cache//
NET_API_STATUS NetrDfsFlushFtTable( [in,string] LPWSTR DcName, [in,string] LPWSTR wszFtDfsName);
//// New apis to work with Ft roots//
NET_API_STATUS NetrDfsAdd2( [in,string] LPWSTR DfsEntryPath, [in,string] LPWSTR DcName, [in,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in,unique,string] LPWSTR Comment, [in] DWORD Flags, [in,out,unique] PDFSM_ROOT_LIST *ppRootList);
NET_API_STATUS NetrDfsRemove2( [in,string] LPWSTR DfsEntryPath, [in,string] LPWSTR DcName, [in,unique,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in,out,unique] PDFSM_ROOT_LIST *ppRootList);
NET_API_STATUS NetrDfsEnumEx( [in,string] LPWSTR DfsEntryPath, [in] DWORD Level, [in] DWORD PrefMaxLen, [in,out,unique] LPDFS_INFO_ENUM_STRUCT DfsEnum, [in,out,unique] LPDWORD ResumeHandle);
NET_API_STATUS NetrDfsSetInfo2( [in,string] LPWSTR DfsEntryPath, [in,string] LPWSTR DcName, [in,unique,string] LPWSTR ServerName, [in,unique,string] LPWSTR ShareName, [in] DWORD Level, [in,switch_is(Level)] LPDFS_INFO_STRUCT pDfsInfo, [in,out,unique] PDFSM_ROOT_LIST *ppRootList);}
|
