3.4.4.3 CprepCsvTestSetup3 (Opnum 5)
ClusterFileShareTestSetupState transitions to ClusterFileShareTestSetup.
The CprepCsvTestSetup3 method can be used to set up in advance any constructs necessary to support calls to IClusterStorage3::CprepCreateNewSmbShares3 or IClusterStorage3::CprepConnectToNewSmbShares3.
-
HRESULT CprepCsvTestSetup3( [in] GUID TestShareGuid, [in, string] LPWSTR Reserved );
TestShareGuid: The client generates a GUID and passes it to all nodes. The GUID can be used to form a unique share name and create the ClusPrepShareList.
Reserved: A string generated on the client and passed to the server. The string MAY be used to supply a user password.
Return Values: A signed 32-bit value that indicates return status. If the method returns a negative value, it has failed. Zero or positive values indicate success, with the lower 16 bits in positive nonzero values containing warnings or flags defined in the method implementation. For more information about Win32 error codes and HRESULT values, see [MS-ERREF] sections 2.2 and 2.1.
-
Return value/code
Description
0x00000000
S_OK
The call was successful.
-
For any other condition, this method MUST return a value that is not one of the values listed in the preceding table. The client MUST behave in one consistent, identical manner for all values that are not listed in the preceding table.
Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].
The opnum field value for this method is 5.
When processing this call, the server MUST do the following:
Set up any constructs necessary to support proper processing of calls to IClusterStorage3::CprepCreateNewSmbShares3. Note that any constructs created in this call SHOULD be cleaned up during the final release on the IClusterStorage3 interface.
Create a set of ClusPrepShares and place them in a ClusPrepShareList that represents shares accessible via an implementation-specific mechanism from other servers.
Change the state of ClusterFileShareTestSetupState to ClusterFileShareTestSetup.