/// <summary>
/// SWN client invoke WitnessrRegister to register for resource state change notifications of a NetName and IPAddress.
/// </summary>
/// <param name="Version">The version of the Witness protocol currently in use by the client.</param>
/// <param name="NetName">Specifies a null-terminated string that specifies the name of the resource for which the client requires notifications.</param>
/// <param name="IpAddr">Specifies a null-terminated string that specifies the IP address to which the client application connection is established.</param>
/// <param name="ClientName">Specifies a null-terminated string that is used to identify the Witness client.</param>
/// <param name="pContext">A context handle to identifies the client on the server. </param>
/// <returns>Return zero if success, otherwise return nonzero.</returns>
public int WitnessrRegister(SwnVersion Version, string NetName, string IpAddr, string ClientName, out IntPtr pContext)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pNetName = Marshal.StringToHGlobalUni(NetName);
SafeIntPtr pIpAddr = Marshal.StringToHGlobalUni(IpAddr);
SafeIntPtr pClientName = Marshal.StringToHGlobalUni(ClientName);
paramList = new Int3264[] {
IntPtr.Zero,//out param
(uint)Version,
pNetName,
pIpAddr,
pClientName,
IntPtr.Zero //return value
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)SWN_OPNUM.WitnessrRegister))
{
pContext = Marshal.ReadIntPtr(outParamList[0]);
retVal = outParamList[paramList.Length - 1].ToInt32();
}
}
finally
{
pNetName.Dispose();
pIpAddr.Dispose();
pClientName.Dispose();
}
return(retVal);
}
/// <summary>
/// This call waits until all the shadowcopy preparation is done on the file server.
/// It is used to avoid the long preparation time on file server break the
/// 60 seconds freeze/thaw window on the application server
/// It must be called between the last AddToShadowCopySet and CommitShadowCopySet
/// </summary>
/// <param name="ShadowCopySetId">The GUID of shadow copy set</param>
/// <param name="TimeOutInMilliseconds">The maximum total time in milliseconds for which the server MUST wait for the expose operation.</param>
/// <returns></returns>
public int PrepareShadowCopySet(
Guid ShadowCopySetId,
uint TimeOutInMilliseconds
)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShadowCopySetId = TypeMarshal.ToIntPtr(ShadowCopySetId);
paramList = new Int3264[] {
pShadowCopySetId,
TimeOutInMilliseconds,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.PrepareShadowCopySet))
{
retVal = outParamList[2].ToInt32();
}
}
finally
{
pShadowCopySetId.Dispose();
}
return(retVal);
}
/// <summary>
/// The IsPathShadowCopied method is invoked by the client to query if any shadow copy for a share already exists.
/// </summary>
/// <param name="ShareName">The full path of the share in UNC format.</param>
/// <param name="ShadowCopyPresent">On output, a Boolean, when set to TRUE, indicates that shadow
/// copies of this share are supported by the server.</param>
/// <param name="ShadowCopyCompatibility">On output, this indicates whether certain I/O operations on the object
/// store containing the shadow copy are disabled. This MUST be zero or a combination of the values
/// as specified in section 2.2.2.2.</param>
/// <returns></returns>
public int IsPathShadowCopied(
string ShareName,
out bool ShadowCopyPresent,
out long ShadowCopyCompatibility)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShareName = Marshal.StringToHGlobalUni(ShareName);
paramList = new Int3264[] {
pShareName,
IntPtr.Zero,
IntPtr.Zero,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.IsPathShadowCopied))
{
retVal = outParamList[paramList.Length - 1].ToInt32();
ShadowCopyPresent = TypeMarshal.ToStruct <bool>(outParamList[1]);
ShadowCopyCompatibility = Marshal.ReadInt32(outParamList[2]);
retVal = outParamList[3].ToInt32();
}
}
finally
{
pShareName.Dispose();
}
return(retVal);
}
/// <summary>
/// The DeleteShareMapping method deletes the mapping of a share’s shadow copy from a shadow copy set.
/// </summary>
/// <param name="ShadowCopySetId">The GUID of the shadow copy set.</param>
/// <param name="ShadowCopyId">The GUID of the shadow copy associated with the share.</param>
/// <param name="ShareName">The name of the share for which the share mapping is to be deleted.</param>
/// <returns></returns>
public int DeleteShareMapping(
Guid ShadowCopySetId,
Guid ShadowCopyId,
string ShareName)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShadowCopySetId = TypeMarshal.ToIntPtr(ShadowCopySetId);
SafeIntPtr pShadowCopyId = TypeMarshal.ToIntPtr(ShadowCopyId);
SafeIntPtr pShareName = Marshal.StringToHGlobalUni(ShareName);
paramList = new Int3264[] {
pShadowCopySetId,
pShadowCopyId,
pShareName,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.DeleteShareMapping))
{
retVal = outParamList[3].ToInt32();
}
}
finally
{
pShadowCopySetId.Dispose();
pShadowCopyId.Dispose();
pShareName.Dispose();
}
return(retVal);
}
/// <summary>
/// The IsPathSupported method is invoked by client to query if a given share is supported by the server
/// for shadow copy operations.
/// </summary>
/// <param name="ShareName">The full path of the share in UNC format.</param>
/// <param name="SupportedByThisProvider">On output, a Boolean, when set to TRUE, indicates that shadow
/// copies of this share are supported by the server.</param>
/// <param name="OwnerMachineName">On output, the name of the server machine to which the client MUST
/// connect to create shadow copies of the specified ShareName.</param>
/// <returns></returns>
public int IsPathSupported(
string ShareName,
out bool SupportedByThisProvider,
out string OwnerMachineName)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShareName = Marshal.StringToHGlobalUni(ShareName);
paramList = new Int3264[] {
pShareName,
IntPtr.Zero,
IntPtr.Zero,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.IsPathSupported))
{
SupportedByThisProvider = TypeMarshal.ToStruct <bool>(outParamList[1]);//(Marshal.ReadInt32(outParamList[1]) == 1);
OwnerMachineName = Marshal.PtrToStringUni(Marshal.ReadIntPtr(outParamList[2]));
retVal = outParamList[3].ToInt32();
}
}
finally
{
pShareName.Dispose();
}
return(retVal);
}
/// <summary>
/// The AbortShadowCopySet method is invoked by the client to delete a given shadow copy set on the server.
/// </summary>
/// <param name="ShadowCopySetId">The GUID of the shadow copy set to which ShareName is to be added.</param>
/// <returns></returns>
public int AbortShadowCopySet(Guid ShadowCopySetId)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShadowCopySetId = TypeMarshal.ToIntPtr(ShadowCopySetId);
paramList = new Int3264[] {
pShadowCopySetId,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.AbortShadowCopySet))
{
retVal = outParamList[1].ToInt32();
}
}
finally
{
pShadowCopySetId.Dispose();
}
return(retVal);
}
/// <summary>
/// The StartShadowCopySet method is called by the client to initiate a new shadow copy set for shadow copy creation.
/// </summary>
/// <param name="pShadowCopySetId">On output, the GUID of the shadow copy set that must be created by server.</param>
/// <returns></returns>
public int StartShadowCopySet(
Guid clientShadowCopySetId,
out Guid pShadowCopySetId)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pClientShadowCopySetId = TypeMarshal.ToIntPtr(clientShadowCopySetId);
paramList = new Int3264[] {
pClientShadowCopySetId,
IntPtr.Zero,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.StartShadowCopySet))
{
pShadowCopySetId = TypeMarshal.ToStruct <Guid>(outParamList[1]);
retVal = outParamList[2].ToInt32();
}
}
finally
{
pClientShadowCopySetId.Dispose();
}
return(retVal);
}
/// <summary>
/// The IDL_DSAExecuteScript method executes a maintenance script.
/// Opnum: 1
/// </summary>
/// <param name="hRpc">
/// The RPC binding handle, as specified in [C706].
/// </param>
/// <param name="dwInVersion">
/// The version of the request message.
/// </param>
/// <param name="pmsgIn">
/// A pointer to the request message.
/// </param>
/// <param name="pdwOutVersion">
/// A pointer to the version of the response message.
/// </param>
/// <param name="pmsgOut">
/// A pointer to the response message.
/// </param>
public uint IDL_DSAExecuteScript(
IntPtr hRpc,
uint dwInVersion,
//[Switch("dwInVersion")]
DSA_MSG_EXECUTE_SCRIPT_REQ?pmsgIn,
out uint?pdwOutVersion,
//[Switch("*pdwOutVersion")]
out DSA_MSG_EXECUTE_SCRIPT_REPLY?pmsgOut)
{
const ushort opnum = 1;
byte[] requestStub;
byte[] responseStub;
Int3264[] paramList;
SafeIntPtr ptrMsgIn = TypeMarshal.ToIntPtr(pmsgIn, dwInVersion, null, null);
paramList = new Int3264[]
{
dwInVersion,
ptrMsgIn,
IntPtr.Zero,
IntPtr.Zero,
0//retVal
};
requestStub = RpceStubEncoder.ToBytes(
RpceStubHelper.GetPlatform(),
DrsrRpcStubFormatString.TypeFormatString,
null,
DrsrRpcStubFormatString.ProcFormatString,
DrsrRpcStubFormatString.Dsaop_ProcFormatStringOffsetTable[opnum],
true,
paramList);
rpceClientTransport.Call(opnum, requestStub, rpceTimeout, out responseStub);
using (RpceInt3264Collection outParamList = RpceStubDecoder.ToParamList(
RpceStubHelper.GetPlatform(),
DrsrRpcStubFormatString.TypeFormatString,
null,
DrsrRpcStubFormatString.ProcFormatString,
DrsrRpcStubFormatString.Dsaop_ProcFormatStringOffsetTable[opnum],
true,
responseStub,
rpceClientTransport.Context.PackedDataRepresentationFormat,
paramList))
{
pdwOutVersion = TypeMarshal.ToNullableStruct <uint>(outParamList[2]);
pmsgOut = TypeMarshal.ToNullableStruct <DSA_MSG_EXECUTE_SCRIPT_REPLY>(
outParamList[3], pdwOutVersion, null, null);
retVal = outParamList[4].ToUInt32();
}
ptrMsgIn.Dispose();
return(retVal);
}
/// <summary>
/// The GetShareMapping method is invoked by the client to get the shadow copy information on a given
/// file share on the server.
/// </summary>
/// <param name="ShadowCopyId">The GUID of the shadow copy associated with the share.</param>
/// <param name="ShadowCopySetId">The GUID of the shadow copy set.</param>
/// <param name="ShareName">The name of the share in UNC format.</param>
/// <param name="Level">The format of this data depends on the value of the level parameter.</param>
/// <param name="ShareMapping">On output, a FSSAGENT_SHARE_MAPPING structure, as specified in section 2.2.3.1.</param>
/// <returns></returns>
public int GetShareMapping(
Guid ShadowCopyId,
Guid ShadowCopySetId,
string ShareName,
uint Level,
out FSSAGENT_SHARE_MAPPING ShareMapping)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pShadowCopyId = TypeMarshal.ToIntPtr(ShadowCopyId);
SafeIntPtr pShadowCopySetId = TypeMarshal.ToIntPtr(ShadowCopySetId);
SafeIntPtr pShareName = Marshal.StringToHGlobalUni(ShareName);
paramList = new Int3264[] {
pShadowCopyId,
pShadowCopySetId,
pShareName,
Level,
IntPtr.Zero,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.GetShareMapping))
{
retVal = outParamList[5].ToInt32();
ShareMapping = new FSSAGENT_SHARE_MAPPING();
if ((FsrvpErrorCode)retVal == FsrvpErrorCode.FSRVP_SUCCESS)
{
ShareMapping.ShareMapping1 = TypeMarshal.ToStruct <FSSAGENT_SHARE_MAPPING_1>(Marshal.ReadIntPtr(outParamList[4]));
ShareMapping.ShareMapping1IsNull = false;
}
else
{
ShareMapping.ShareMapping1IsNull = true;
}
}
}
finally
{
pShadowCopyId.Dispose();
pShadowCopySetId.Dispose();
pShareName.Dispose();
}
return(retVal);
}
/// <summary>
/// The AddToShadowCopySet method adds a share to an existing shadow copy set.
/// </summary>
/// <param name="ClientShadowCopyId">The GUID of the client. This MUST be set to NULL.</param>
/// <param name="ShadowCopySetId">The GUID of the shadow copy set to which ShareName is to be added.</param>
/// <param name="ShareName">The name of the share in UNC format for which a shadow copy is required.</param>
/// <param name="pShadowCopyId">On output, the GUID of the shadow copy associated to the share.</param>
/// <returns></returns>
public int AddToShadowCopySet(
Guid ClientShadowCopyId,
Guid ShadowCopySetId,
string ShareName,
out Guid pShadowCopyId)
{
Int3264[] paramList;
int retVal = 0;
SafeIntPtr pClientShadowCopyId = TypeMarshal.ToIntPtr(ClientShadowCopyId);
SafeIntPtr pShadowCopySetId = TypeMarshal.ToIntPtr(ShadowCopySetId);
SafeIntPtr pShareName = Marshal.StringToHGlobalUni(ShareName);
paramList = new Int3264[] {
pClientShadowCopyId,
pShadowCopySetId,
pShareName,
IntPtr.Zero,
IntPtr.Zero
};
try
{
using (RpceInt3264Collection outParamList = RpceCall(paramList, (ushort)FSRVP_OPNUM.AddToShadowCopySet))
{
pShadowCopyId = TypeMarshal.ToStruct <Guid>(outParamList[3]);
retVal = outParamList[4].ToInt32();
}
}
finally
{
pClientShadowCopyId.Dispose();
pShadowCopySetId.Dispose();
pShareName.Dispose();
}
return(retVal);
}
