Registrace COM objektu kontextové nabídky ve specifikátoru zobrazení

Pokud pomocí modelu COM vytvoříte knihovnu DLL rozšíření místní nabídky pro adresářovou službu Active Directory, musí být toto rozšíření registrováno v registru systému Windows a službách domén Active Directory, aby informovalo moduly snap-in konzoly MMC pro správu služby Active Directory a shell systému Windows o tomto rozšíření.

Registrace v registru Systému Windows

Stejně jako všechny servery COM musí být rozšíření místní nabídky zaregistrováno v registru. Rozšíření se zaregistruje pod následujícím klíčem.

HKEY_CLASSES_ROOT
   CLSID
      <clsid>

<clsid> je řetězcová reprezentace CLSID vytvořená funkcí StringFromCLSID. Pod klíčem <clsid> existuje klíč InProcServer32, který identifikuje objekt jako 32bitový server in-proc. Pod klíčem InProcServer32 je umístění knihovny DLL uvedeno ve výchozí hodnotě a model threadingu ve hodnotě ThreadingModel. Všechna rozšíření místní nabídky musí používat model vláken "Apartment".

Registrace ve službě Active Directory Domain Services

Registrace rozšíření místní nabídky je specifická pro jedno národní prostředí. Pokud se rozšíření místní nabídky vztahuje na všechny lokality, musí být registrováno ve třídě objektu displaySpecifier objekt ve všech podkontejnerech kontejneru Display Specifiers pro jednotlivé lokality. Pokud je rozšíření místní nabídky lokalizované pro určité národní prostředí, musí být registrováno v objektu displaySpecifier v podkontejneru daného národního prostředí. Pro více informací o kontejneru Specifikátory Zobrazení a lokalizacích, viz Specifikátory Zobrazení a Kontejner Specifikátory Zobrazení.

Existují dva atributy specifikátoru zobrazení, pod které lze zaregistrovat položku rozšíření místní nabídky. Jedná se o adminContextMenu a shellContextMenu.

Atribut adminContextMenu identifikuje místní nabídky pro správu, které se mají zobrazit v modulu snap-in pro správu služby Active Directory. Místní nabídka se zobrazí, když uživatel zobrazí místní nabídku pro objekty příslušné třídy v jednom z modulů snap-in konzoly MMC pro správu služby Active Directory.

Atribut shellContextMenu identifikuje místní nabídky koncového uživatele, které se mají zobrazit ve Windows shellu. Místní nabídka se zobrazí, když uživatel zobrazí místní nabídku pro objekty příslušné třídy v Průzkumníku Windows. Od systému Windows Server 2003 už prostředí Windows nezobrazuje objekty služby Active Directory Domain Services.

Všechny tyto atributy jsou vícehodnotové.

Při registraci rozšíření místní nabídky se pro atributy adminContextMenu a shellContextMenu vyžadují hodnoty v následujícím formátu.

<order number>,<clsid>

"<číslo objednávky>" je číslo bez znaménka, které představuje pozici položky v místní nabídce. Když se zobrazí místní nabídka, hodnoty se seřadí pomocí porovnání jejich "<pořadového čísla>". Pokud více než jedna hodnota má stejné "<pořadové číslo>", tato rozšíření místní nabídky se načítají v pořadí, v jakém jsou čteny ze serveru služby Active Directory. Pokud je to možné, použijte neexistující "<číslo objednávky>", tj. ten, který nebyl použit jinými hodnotami ve vlastnosti. V pořadí "<číslo objednávky>" nejsou povoleny žádné předepsané počáteční pozice a mezery.

"<clsid>" je řetězcová reprezentace CLSID, která je vytvořena pomocí funkce StringFromCLSID."

V prostředí Windows jsou podporovány položky místní nabídky s vícenásobným výběrem. V tomto případě se pro každý vybraný objekt vyvolá rozšíření místní nabídky. V modulu snap-in pro správu služby Active Directory jsou podporovány také položky rozšíření místní nabídky s vícenásobným výběrem. V tomto případě bude struktura DSOBJECTNAMES obsahovat strukturu DSOBJECT pro každý vybraný objekt adresáře.

Důležitý

V prostředí Windows se informace o specifikátoru zobrazení načtou při přihlášení uživatele a uloží se do mezipaměti pro jeho relaci. U modulů snap-in pro správu se data specifikátoru zobrazení načtou při načtení modulu snap-in a po dobu trvání procesu se ukládají do mezipaměti. U prostředí Windows to znamená, že změny specifikátorů zobrazení se projeví po odhlášení a opětovném zapnutí uživatele. U modulů snap-in pro správu se změny projeví při opětovném načtení souboru modulu snap-in nebo konzoly. To znamená, že pokud spustíte novou instanci souboru konzoly nebo novou instanci Mmc.exe a přidáte modul snap-in, načte se nejnovější data specifikátoru zobrazení.

 

Další informace a příklad kódu, jak realizovat rozšíření místní nabídky, najdete v tématu Příklad kódu pro implementaci COM objektu místní nabídky.