Metoda SetSecurityDescriptor třídy __SystemSecurity

Metoda SetSecurityDescriptor zapíše aktualizovanou verzi popisovače zabezpečení, která řídí přístup k oboru názvů rozhraní WMI, ke kterému jste připojeni. Popisovač zabezpečení je reprezentován instancí __SecurityDescriptor. Další informace naleznete v tématu Změna zabezpečení přístupu u zabezpečitelných objektů.

Syntaxe

uint32 SetSecurityDescriptor(
  [in] __SecurityDescriptor Descriptor
);

Parametry

Popisovač [in]

Popisovač zabezpečení přidružený k oboru názvů WMI.

Návratová hodnota

Vrátí jednu z hodnot uvedených v následujícím seznamu nebo jinou hodnotu, která označuje chybu. Další informace naleznete v tématu Návratové kódy rozhraní WMI nebo WbemErrorEnum.

0

Úspěšné dokončení

2

Uživatel nemá přístup k požadovaným informacím.

8

Neznámá chyba.

9

Uživatel nemá odpovídající oprávnění ke spuštění metody.

21

Parametr zadaný ve volání metody není platný.

Poznámky

Instance Win32_SecurityDescriptor představuje datový typ SECURITY_DESCRIPTOR_CONTROL a obsahuje volitelný seznam řízení přístupu (DACL) a seznam řízení přístupu systému (SACL). Další informace naleznete v tématu Seznamy řízení přístupu.

Pokud SeSecurityPrivilege není udělen nebo povolen při získávání popisovače zabezpečení, vrátí se ve vráceném popisovači zabezpečení pouze seznam DACL. Další informace naleznete v tématu Konstanty oprávnění a provádění privilegovaných operací.

Při volání této metody můžete aktualizovat seznam DACL i SACL v Win32_SecurityDescriptor instanci, ale můžete také aktualizovat pouze seznam DACL nebo pouze SACL.

Následující hodnoty v SECURITY_DESCRIPTOR_CONTROL určují, jestli se seznam DACL nebo SACL nebo oba aktualizují.

• SE_DACL_PRESENT

  Označuje, že seznam DACL by se měl aktualizovat. Pokud toto nastavení není nastavené, WMI zachová původní hodnotu seznamu DACL.

• SE_SACL_PRESENT

  Označuje, že sacl by se měl aktualizovat. Pokud toto nastavení není nastavené, WMI zachová původní hodnotu SACL. Pokud chcete aktualizovat SACL, musí mít účet povolené oprávnění SeSecurityPrivilege . Pro skriptování je název oprávnění SeSecurityPrivilege. Další informace naleznete v tématu Konstanty oprávnění.

Pokud správce skupiny a vlastnosti správce vlastníka nemají hodnotu NULL, aktualizují se. V opačném případě WMI zachová původní hodnoty. Další informace naleznete v tématu Objekty popisovače zabezpečení rozhraní WMI.

Pokud je v volání této metody nový SACL null , pak popisovač zabezpečení SACL cílového zabezpečitelného objektu zůstane beze změny.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows Vista
Minimální podporovaný server	Windows Server 2008
Namespace	Všechny obory názvů služby WMI

Viz také

__SystemSecurity

Nastavení bezpečnostních popisovačů oboru názvů