IsPathSupported (Opnum 8)

The IsPathSupported method is invoked by the client to query if a given share is supported by the server for shadow copy operations.

 DWORD IsPathSupported(
         [in] handle_t hBinding,
         [in] [string] LPWSTR ShareName,
         [out] BOOL* SupportedByThisProvider,
         [out] [string] LPWSTR* OwnerMachineName);

hBinding:  An RPC binding handle (as defined in [C706]).

ShareName: The full path of the share in UNC format.

SupportedByThisProvider:  A Boolean, when set to TRUE, that indicates that shadow copies of this share are supported by the server.

OwnerMachineName:  The name of the server machine to which the client MUST connect to create shadow copies of the specified ShareName.

Return Values: The method returns one of the values as specified in section 2.2.4. The most common error codes are listed in the following table:

Return value/code




The caller does not have the permissions to perform the operation.



One or more arguments are invalid.



The file store that contains the share to be shadow copied is not supported by the server.

The server MUST verify that the share identified by ShareName exists on the server, by invoking the event as specified in [MS-SMB2] section or [MS-CIFS] section If the share does not exist, the server MUST fail the call with FSRVP_E_OBJECT_NOT_FOUND.

The server MUST identify the file store on which the ShareName is hosted, in an implementation-defined manner. If the object store has mount points underneath or if the file store is not supported by the underlying shadow copy utility, the server MUST fail the call with FSRVP_E_NOT_SUPPORTED.

The server MUST set OwnerMachineName to the name of the server which it requires the client to connect to create shadow copies for the specified ShareName. The server MUST set SupportedByThisProvider to TRUE and return ZERO to the caller.