IPXV_Inst::PathToName Method

Revision as of 17:50, 25 May 2015

Resolves the input path to the IAFS_Name object. The function will automatically bind to source file-system and if authentication is required - perform UI for authentication.

Syntax

HRESULT PathToName([in]                    LPWSTR        pPath,
                   [in, defaultvalue(0)]   VARIANT_BOOL  bDIPath,
                   [in, defaultvalue("")]  BSTR          pFSName,
                   [in, defaultvalue(-1)]  VARIANT_BOOL  bAllowAuth,
                   [in, defaultvalue(0)]   HANDLE_T      hWndParent,
                   [out, retval]           IAFS_Name**   ppRes);

Parameters

pPath

[in] The string that contains path to the resource.

bDIPath

[in, defaultvalue(0)] The optional flag, indicates should the input path be interpreted as device-independed.

pFSName

[in, defaultvalue("")] The optional value, may contain the name of source file system. If not specified the function will try to choose file system by input path.

bAllowAuth

[in, defaultvalue(-1)] The optional flag to allow/prevent the interactive authentication.

hWndParent

[in, defaultvalue(0)] Specifies handle of parent window for any possible interactions inside function. The value is optional and you may pass NULL there.

ppRes

[out, retval] Returns pointer to IAFS_Name object.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXV_Inst