导航:  Windows Procedures >

AfxGetKnowFolderPath

上一页返回章节概述下一页

描述

 

检索特殊文件夹的路径.需要Windows Vista / Windows 7或上级.

 

FreeBASIC 语法

 

FUNCTION AfxGetKnowFolderPath ( _

  BYVAL rfid AS CONST KNOWNFOLDERID CONST PTR, _

  BYVAL dwFlags AS DWORD = 0, _

  BYVAL hToken AS HANDLE = NULL _

) AS CWSTR

 

参数

 

rfid

 

参考标识文件夹的KNOWNFOLDERID.与已知文件夹ID关联的文件夹可能不存在于特定系统中.

 

dwFlags

 

指定特殊检索选项的标志.这个值可以是0;否则,它是一个或一个以上的KNOWN_FOLDER_FLAG值.

 

hToken

 

用于表示特定用户的访问令牌.这个参数通常设置为NULL,这样函数试图访问该文件夹的用户当前的实例.但是,您可能需要指定一个值hToken这些文件夹,可以有多个用户,但被视为属于单用户.这种类型的最常用文件夹是文档.调用应用程序负责正确模拟当hToken非空.它必须为特定的用户有适当的安全权限,包括TOKEN_QUERY和TOKEN_IMPERSONATE,和用户的注册表配置单元必须安装在.看到访问控件的访问控件问题的进一步讨论:http:/ / MSDN.微软.COM /我们/图书馆/窗口/桌面/ aa374860(V = vs.85 aspx).

 

分配hToken参数值1表示默认的用户.这允许客户SHGetKnownFolderIDList找到文件夹的位置(如桌面文件夹)的默认用户.默认用户用户配置文件将在创建新用户帐户时复制,并包括文档和桌面等特殊文件夹.添加到默认用户文件夹中的任何项目也将出现在任何新用户帐户中.注意访问默认用户文件夹需要管理员权限.

 

返回值

 

成功的请求文件夹的路径,或失败时的空字符串.

 

备注

 

一列KNOWNFOLDERID常数见:< a href ='http:/ / MSDN.微软.COM /我们/图书馆/窗口/桌面/ dd378457(V = vs.85).aspx'目标='_blank'class='链接'> https: / / MSDN.微软.COM /我们/图书馆/窗口/桌面/ dd378457(V = vs.85).aspx </a>

用法示例

 

AfxGetKnowFolderPath(@FOLDERID_CommonPrograms)

 

引用文件

 

AfxWin.inc