Registrace položky statické místní nabídky

Moduly snap-in konzoly MMC pro správu služby Active Directory Domain Services a prostředí systému Windows poskytují mechanismus pro přidání položky do místní nabídky zobrazené pro objekty ve službě Active Directory Domain Services. Místní nabídka může vyvolat libovolný soubor, který lze spustit pomocí rozhraní ShellExecute API, jako je například aplikace nebo adresa URL webové stránky.

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 národní prostředí, musí být registrováno ve třídě objektu displaySpecifier objekt ve všech podkontejnerech národního prostředí v kontejneru Display Specifiers. 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 subkontejneru pro dané národní prostředí. Další informace o kontejneru Display Specifiers a národních prostředích naleznete v tématu Specifikátory zobrazení a Kontejner Display Specifiers.

Existují dva atributy specifikátoru zobrazení, pod kterými lze zaregistrovat statickou položku místní nabídky: adminContextMenu a shellContextMenu.

Atribut adminContextMenu identifikuje kontextové nabídky pro správu, které se mají zobrazit v administrativních zásuvných modulech služby Active Directory Domain Services. 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.

Atribut shellContextMenu identifikuje místní nabídky pro koncového uživatele, které se mají zobrazit v prostředí Windows. 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 ze služby Active Directory Domain Services.

Všechny tyto atributy jsou vícehodnotové.

Při registraci položky statické místní nabídky je vyžadován následující formát pro atributy adminContextMenu a shellContextMenu.

<order number>,<menu text>,<command>

"<čí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í "<číslo objednávky>". Pokud má více hodnot stejné "<číslo pořadí>", pak se tato rozšíření místní nabídky načítají v pořadí, v jakém jsou čteny ze serveru služby Active Directory. Pokud je to možné, použijte číslo objednávky „<>“, které ještě neexistuje, to znamená, že nebylo použito jinými hodnotami ve vlastnosti. Neexistuje žádná předepsané počáteční pozice a mezery jsou povoleny v posloupnosti "<číslo objednávky>".

Text nabídky<>je řetězec zobrazený v místní nabídce. Text nabídky<>může obsahovat jeden znak&, který předchází znaku klávesové zkratky pro položku nabídky. To způsobí podtržení předchozího znaku. Pokud je například text nabídky<>„&Soubor", text nabídky se zobrazí jako „Soubor", podtrhne se „F" a „F" bude klávesová zkratka pro položku nabídky.

Příkaz<>je program nebo soubor spouštěný modulem snap-in. Buď musí být zadána úplná cesta, nebo soubor musí existovat v proměnné prostředí cesty počítače. Soubor se vyvolá pomocí funkce ShellExecute. Příkaz<>nemůže obsahovat další parametry, například Notepad.exe Myfile.txt. Vzhledem k tomu, že se používá ShellExecute, lze pro "příkaz<>" použít libovolný soubor nebo adresu, které lze předat ShellExecute. Pokud například "<příkaz>" obsahuje "d:\file.txt", d:\file.txt will be opened with the application associated with the .txt rozšíření. Podobně platí, že pokud<příkaz>obsahujehttps://www.fabrikam.com", otevře se výchozí webový prohlížeč a zobrazí se zadaná webová stránka. Cesty a názvy aplikací s mezerami jsou povolené. Pokud je<příkaz>aplikace, předají se jako argumenty příkazového řádku oddělené mezerou vybrané objekty ADsPath a třída.

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á „<příkaz>“. V modulu snap-in pro správu služby Active Directory Domain Services nejsou podporovány položky statické místní nabídky s více výběry.

Důležitý

Specifikátor zobrazení pro prostředí Windows se načte při přihlášení uživatele a uloží do mezipaměti na dobu trvání uživatelovy relace. 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čtou se nejnovější data specifikátoru zobrazení.

 

Další informace, a příklad kódu, najdete v tématu Příklad kódu pro instalaci položky statické místní nabídky.