Megosztás a következőn keresztül:

Ismert mappák használata az alkalmazásokban

  • Cikk

Az Ismert mapparendszer lehetővé teszi bizonyos magas profilú mappák kezelését, amelyek alapértelmezés szerint megtalálhatók a Windowsban. Ugyanezeket az interakciókat az ismert mapparendszerben alkalmazások által telepített és regisztrált mappákkal is lehetővé teszi. Ez a témakör az ismert mappa API-k által biztosított lehetséges interakciókat ismerteti.

Fontos

A Dokumentumok, Képek vagy Asztali mappák OneDrive-ra való átirányításához használja a OneDrive Ismert mappa áthelyezése lehetőséget a cikkben ismertetett átirányítási módszer helyett. További információ: Ismert Windows-mappák átirányítása és áthelyezése a OneDrive.

Ismert mappafelületek

Két ismert mappafelület létezik: IKnownFolder és IKnownFolderManager.

IKnownFolderManager számos általánosabb funkciót biztosít ezekre a mappákra vonatkozóan. Módszerei lehetővé teszik, hogy:

  • Egy IKnownFolder- lekérése a mappa KNOWNFOLDERID, annak kanonikus neve, sztringként kifejezett elérési útja, vagy IDListként kifejezett elérési útja alapján.
  • Alakítsa át a CSIDL-t a ISMERTFOLDERID-ekvivalenssé, vagy alakítsa át egy ISMERTFOLDERID régi CSIDL-ekvivalenssé.
  • Ismert mappa regisztrálása vagy regisztrációjának törlése a rendszerben.
  • Kérje le a KNOWNFOLDERID értékeit, amelyek azon a rendszeren vannak regisztrálva.
  • Ismert mappa átirányítása új helyre.

IKnownFolder olyan módszert biztosít, amely lehetővé teszi, hogy egy mappa egy új elérési út megadásával átirányítsa magát. Más metódusai információkat kapnak egy adott ismert mappáról, beleértve a következőket:

  • A mappa kategóriája: virtuális, rögzített, gyakori vagy felhasználónkénti.
  • A mappa típusa, például tömörített, dokumentumok, képek vagy felhasználói fájlok.
  • A mappa ismert mappaazonosítója: KNOWNFOLDERID.
  • A mappa teljes elérési útja azonosító lista vagy sztring formájában. Valamint a szülőmappa relatív elérési útja.
  • A mappa kanonikus neve.
  • A mappához megjelenített magyarázatszöveg.
  • A mappához megjelenített ikon.
  • A mappa leírása, amely ismerteti annak célját és használatát.
  • Azt jelzi, hogy a mappa átirányítható-e.

IKnownFolder a mappa alapján egy IShellItem lekérésére is szolgál. Így egy kezelőhöz kötheti a mappát, összehasonlíthat két mappát, és lekérheti a mappa attribútumait, megjelenítendő nevét és szülőmappáját.

Átirányítás

A mappaátirányítás az ismert mapparendszer fontos funkciója. A kategóriába tartozó összes ismert mappa - legyen az általánosKF_CATEGORY_COMMON**** vagy felhasználónkéntiKF_CATEGORY_PERUSER**** - átirányítható. A virtual KF_CATEGORY_VIRTUAL**** vagy KF_CATEGORY_FIXED****kategóriamappája azonban nem irányítható át.

A mappák átirányíthatók ugyanahhoz a számítógéphez vagy egy hálózati helyre. Hálózati átirányítás esetén a mappa ügyféloldali gyorsítótárazással helyileg tárolható, hogy offline hozzáférést biztosítson. Azonban még ha létezik is helyi gyorsítótár, az átirányított mappához akkor is a hálózaton keresztül kell hozzáférni.

A mappaátirányítás nem új Windows Vista rendszerben. Windows XP rendszerben például a CSIDL-rendszeren keresztül azonosított mappákat átirányíthatja az SHSetFolderPathhívásával, vagy a CSIDL bejegyzésének módosításával a beállításjegyzékben. Windows Vista és újabb rendszereken az átirányítást IKnownFolder::SetPath vagy SHSetKnownFolderPathkell végrehajtani.

Annak megállapításához, hogy egy mappa átirányítható-e, hívja meg IKnownFolder::GetRedirectionCapabilities. Ha a mappa nem irányítható át, ez a hívás magyarázatot adhat.

Ha egy mappát hálózati helyre irányít át, a IKnownFolder metódusok továbbra is sikeresen meghívhatók rajta.

Ismert mappák mintapéldája