3.2.4.2.12.1 GetSharePathsForLocalPath (Opnum 7)

The GetSharePathsForLocalPath method returns all the network share paths that point to the specified local path.

 [id(FSRM_DISPID_PATHMAPPER | 0x01)] HRESULT GetSharePathsForLocalPath(
   [in] BSTR localPath,
   [out, retval] SAFEARRAY (VARIANT)* sharePaths
 );

localPath: Contains the local path for which to return network shares for.

sharePaths: Pointer to a SAFEARRAY that upon completion contains all the network share paths that point to the specified path.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80045306

FSRM_E_INVALID_PATH

The local path to return network shares does not exist or exceeds the maximum length of 260 characters.

0x80070057

E_INVALIDARG

This code is returned for the following reasons:

  • The localPath parameter is empty or NULL.

  • The sharePaths parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that localPath directory is not NULL or empty.

  • Verify that sharePaths is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST populate sharePaths with all the network share paths that have the localPath as a parent directory.