« AddAccessAllowedAceEx, funkcja »
Dodaje wejście kontroli przyznania dostępu (ACE) na końcu uznanej listy kontroli dostępu (DACL). (funkcja)
Logowanie
Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Zapomniałem hasła
Polska dokumentacja C++ » Biblioteki C/C++ » WinAPI » Autoryzacja
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

AddAccessAllowedAceEx

[funkcja] Dodaje wejście kontroli przyznania dostępu (ACE) na końcu uznanej listy kontroli dostępu (DACL).

Składnia

C/C++
#include <windows.h>

BOOL WINAPI AddAccessAllowedAceEx(
PACL pAcl,
DWORD dwAceRevision,
DWORD AceFlags,
DWORD AccessMask,
PSID pSid
);

Argumenty

ArgumentOpis
pAclWskaźnik do DACL.
dwAceRevisionOkreśla rodzaj modyfikacji przed zmianą DACL. Wartość tego argumentu może wynosić ACL_REVISION (lub ACL_REVISION_DS jeśli DACL zawiera obiekty ACE).
AceFlagsFlagi określające dziedziczenie ACE. Funkcja umieszcza je w składowej AceFlags struktury ACE_HEADER nowego ACE. Wartość tego argumentu może być połączeniem poniższych stałych:
StałaObiekty dziedziczące
CONTAINER_INHERIT_ACEobiekty kontenerów
INHERIT_ONLY_ACEtylko obiekty potomne
INHERITED_ACEdowolne obiekty
NO_PROPAGATE_INHERIT_ACEbrak
OBJECT_INHERIT_ACEobiekty niebędące obiektami kontenerów
AccessMaskMaska z uprawnieniami dostępu do SID w formacie ACCESS_MASK.
pSidWskaźnik do SID.

Zwracana wartość

Jeśli funkcja zakończy się bez błędów, zwracana wartość jest niezerowa, inaczej zero. Aby uzyskać rozszerzone informacje o błędach, należy wywołać funkcję » WinAPI ♦ GetLastError, która może w tym przypadku zwrócić następujące wartości:
BłądZnaczenie
ERROR_ALLOTTED_SPACE_EXCEEDEDNowe ACE nie mieści się na ACL (potrzebny jest większy bufor).
ERROR_INVALID_ACLNieprawidłowa wartość ACL.
ERROR_INVALID_FLAGSNieprawidłowa wartość argumentu [tt]AceFlags[/tt].
ERROR_INVALID_SIDNieprawidłowa wartość SID.
ERROR_REVISION_MISMATCHNieprawidłowy rodzaj modyfikacji.
ERROR_SUCCESSNie wystąpiły żadne błędy.

Dodatkowe informacje

Ta funkcja dodaje ACE (w postaci struktury ACCESS_ALLOWED_ACE) na końcu listy DACL. Podmiot wywołujący musi zapewnić dodawanie ACE do DACL we właściwej kolejności.

Wymagania

Minimalny system klientaWindows XP (tylko aplikacje biurowe).
Minimalny system serweraWindows Server 2003 (tylko aplikacje biurowe).
NagłówekWinbase.h (dołącza Windows.h).
BibliotekaAdvapi32.lib
DLLAdvapi32.dll

Zagadnienia powiązane

AddAccessAllowedAceDodaje wejście kontroli przyznania dostępu (ACE) do listy kontroli dostępu (ACL). (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.
Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.
© Wszelkie prawa zastrzeżone 2005-2024