IPXV_Inst::PathToName Method

Revision as of 06:32, 12 June 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        Path,
                   [in, defaultvalue(0)]   VARIANT_BOOL  DIPath,
                   [in, defaultvalue("")]  BSTR          FSName,
                   [in, defaultvalue(-1)]  VARIANT_BOOL  AllowAuth,
                   [in, defaultvalue(0)]   HANDLE_T      hWndParent,
                   [out, retval]           IAFS_Name**   Res);

Parameters

Path

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

DIPath

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

FSName

[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.

AllowAuth

[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.

Res

[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