Share via

IKnownFolderManager：：GetFolder 方法 (shobjidl_core.h)

  • 發行項

取得物件，表示其 KNOWNFOLDERID 所識別的已知資料夾。 物件可讓您查詢特定資料夾屬性、取得資料夾的目前路徑、將資料夾重新導向至另一個位置，以及取得資料夾的路徑做為 ITEMIDLIST。

語法

HRESULT GetFolder(
  [in]  REFKNOWNFOLDERID rfid,
  [out] IKnownFolder     **ppkf
);

參數

[in] rfid

類型： REFKNOWNFOLDERID

KNOWNFOLDERID 的參考。

[out] ppkf

類型： IKnownFolder**

當這個方法傳回時，會包含代表資料夾之 IKnownFolder 物件的介面指標。

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值，包括下列專案：

傳回碼 Description
E_INVALIDARG
 此外，這個值也可以指出 ，此標識符會 參考系統上不存在的 KNOWNFOLDERID 。 並非所有 KNOWNFOLDERID 值都存在於所有系統上。 使用 IKnownFolderManager：：GetFolderIds 來擷取目前系統的 KNOWNFOLDERID 值集。

備註

若要呼叫這個方法，呼叫端必須至少有用戶許可權。

使用時機

當您知道您要尋找的已知資料夾，並想要直接存取它時，請使用這個方法。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll

另請參閱

IKnownFolderManager

已知資料夾範例