IPXV_Inst::GetStdFolder Method

From PDF XChange PDF SDK
Jump to: navigation, search
Line 15: Line 15:
 
== Parameters ==
 
== Parameters ==
 
;nFolderID
 
;nFolderID
:[in]  Value of [[PXV:PXV_StdFolderID|PXV_StdFolderID]] with Folder ID.
+
:[in]  Value of [[PXV:PXV_StdFolderID|PXV_StdFolderID]] enumeration.
 
;bUser
 
;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 <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:
Line 24: Line 24:
 
:[in, defaultvalue(0)]  Value of VARIANT_BOOL to create folder if it does not exist.
 
:[in, defaultvalue(0)]  Value of VARIANT_BOOL to create folder if it does not exist.
 
;ppFolderPath
 
;ppFolderPath
:[out, retval]  Folder path to specified folder. ''ppFolderPath'' always contains '\' at the end.
+
:[out, retval]  Returns the full path to the specified folder, always contains '\' letter at the end.
  
 
== Return Value ==
 
== Return Value ==

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