« AddAccessAllowedAce, funkcja »
Dodaje wejście kontroli przyznania dostępu (ACE) do listy kontroli dostępu (ACL). (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++

AddAccessAllowedAce

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

Składnia

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

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

Argumenty

ArgumentOpis
pAclWskaźnik do ACL.
dwAceRevisionOkreśla rodzaj modyfikacji przed zmianą ACL. Wartość tego argumentu może wynosić ACL_REVISION (lub ACL_REVISION_DS jeśli ACL zawiera obiekty ACE).
AccessMaskMaska z uprawnieniami dostępu do SID.
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_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 ACL. Jest to najbardziej powszechny sposób zmiany tej listy. Dostęp jest przyznawany dla określonego identyfikatora zabezpieczeń (SID). SID może określać na przykład użytkownika, grupę lub konto podczas logowania. Funkcje dodające nowe ACE na końcu ACL nie umieszczają automatycznie nowego ACE we właściwym miejscu na liście. Za dodawanie elementów na końcu listy w prawidłowej kolejności odpowiada podmiot wywołujący tą funkcję. Struktura ACE_HEADER umieszczona w ACE określa typ i rozmiar, ale nie zawiera informacji o dziedziczeniu ani innych flag ACE.

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

AddAccessAllowedAceExDodaje wejście kontroli przyznania dostępu (ACE) na końcu uznanej listy kontroli dostępu (DACL). (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