IPXV_Inst::GetStdFolder Method

From PDF XChange PDF SDK
Jump to: navigation, search
Line 19: Line 19:
 
:[in]  The boolean flag that indicates what type of path should be in output: application's or user's. For example, by default, for identifier <tt>PXV_StdFolder_Root</tt> and when <tt>bUser</tt> is specified to <tt>false</tt> the function will return:
 
:[in]  The boolean flag that indicates what type of path should be in output: application's or user's. For example, by default, for identifier <tt>PXV_StdFolder_Root</tt> and when <tt>bUser</tt> is specified to <tt>false</tt> the function will return:
 
::<tt>c:\Program Files\Tracker Software\PDF Editor\</tt>
 
::<tt>c:\Program Files\Tracker Software\PDF Editor\</tt>
:but with <tt>bUser</tt> specified to <tt>true</tt>:
+
::but with <tt>bUser</tt> specified to <tt>true</tt>:
 
::<tt>c:\Users\root\AppData\Roaming\Tracker Software\PDFXEditor\3.0\</tt>
 
::<tt>c:\Users\root\AppData\Roaming\Tracker Software\PDFXEditor\3.0\</tt>
 
;bCreateIfNotExists
 
;bCreateIfNotExists

Revision as of 15:37, 25 May 2015


Gets full path to special program folder.

Syntax

HRESULT GetStdFolder([in]                   PXV_StdFolderID  nFolderID,
                     [in]                   VARIANT_BOOL     bUser,
                     [in, defaultvalue(0)]  VARIANT_BOOL     bCreateIfNotExists,
                     [out, retval]          BSTR*            ppFolderPath);

Parameters

nFolderID
[in] Value of PXV_StdFolderID enumeration.
bUser
[in] The boolean flag that indicates what type of path should be in output: application's or user's. For example, by default, for identifier PXV_StdFolder_Root and when bUser is specified to false the function will return:
c:\Program Files\Tracker Software\PDF Editor\
but with bUser specified to true:
c:\Users\root\AppData\Roaming\Tracker Software\PDFXEditor\3.0\
bCreateIfNotExists
[in, defaultvalue(0)] Value of VARIANT_BOOL to create folder if it does not exist.
ppFolderPath
[out, retval] Returns the full path to the specified folder, always contains '\' letter at the end.

Return Value

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

See Also

IPXV_Inst