Globale beveiligingsfuncties

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze functies bieden ondersteuning voor het wijzigen van SID- en ACL-objecten.

Belangrijk

De functies in de volgende tabel kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Naam	Description
AtlGetDacl	Roep deze functie aan om de DACL-gegevens (discretionaire toegangsbeheerlijst) van een opgegeven object op te halen.
AtlSetDacl	Roep deze functie aan om de DACL-gegevens (discretionaire toegangsbeheerlijst) van een opgegeven object in te stellen.
AtlGetGroupSid	Roep deze functie aan om de groepsbeveiligings-id (SID) van een object op te halen.
AtlSetGroupSid	Roep deze functie aan om de groepsbeveiligings-id (SID) van een object in te stellen.
AtlGetOwnerSid	Roep deze functie aan om de beveiligings-id (SID) van de eigenaar van een object op te halen.
AtlSetOwnerSid	Roep deze functie aan om de beveiligings-id (SID) van de eigenaar van een object in te stellen.
AtlGetSacl	Roep deze functie aan om de systeemtoegangsbeheerlijstgegevens (SACL) van een opgegeven object op te halen.
AtlSetSacl	Roep deze functie aan om de SACL-gegevens (System Access Control List) van een opgegeven object in te stellen.
AtlGetSecurityDescriptor	Roep deze functie aan om de beveiligingsdescriptor van een bepaald object op te halen.

Requirements

Koptekst: atlsecurity.h

AtlGetDacl

Roep deze functie aan om de DACL-gegevens (discretionaire toegangsbeheerlijst) van een opgegeven object op te halen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlGetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CDacl* pDacl) throw();

Parameterwaarden

hObject
Verwerken naar het object waarvoor de beveiligingsgegevens moeten worden opgehaald.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

pDacl
Wijs een DACL-object aan dat de opgehaalde beveiligingsgegevens bevat.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Opmerkingen

In builds voor foutopsporing treedt een assertiefout op als hObject of pDacl ongeldig is.

AtlSetDacl

Roep deze functie aan om de DACL-gegevens (discretionaire toegangsbeheerlijst) van een opgegeven object in te stellen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlSetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CDacl& rDacl,
    DWORD dwInheritanceFlowControl = 0) throw(...);

Parameterwaarden

hObject
Afhandelen naar het object waarvoor beveiligingsgegevens moeten worden ingesteld.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

rDacl
De DACL met de nieuwe beveiligingsgegevens.

dwInheritanceFlowControl
Het beheer van de overnamestroom. Deze waarde kan 0 (de standaardinstelling), PROTECTED_DACL_SECURITY_INFORMATION of UNPROTECTED_DACL_SECURITY_INFORMATION zijn.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Opmerkingen

In builds voor foutopsporing treedt een assertiefout op als hObject ongeldig is of als dwInheritanceFlowControl geen van de drie toegestane waarden is.

Requirements

Koptekst: atlsecurity.h

AtlGetGroupSid

Roep deze functie aan om de groepsbeveiligings-id (SID) van een object op te halen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlGetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parameterwaarden

hObject
Greep naar het object van waaruit beveiligingsgegevens moeten worden opgehaald.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

pSid
Wijs een CSid object aan dat de nieuwe beveiligingsgegevens bevat.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Requirements

Koptekst: atlsecurity.h

AtlSetGroupSid

Roep deze functie aan om de groepsbeveiligings-id (SID) van een object in te stellen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlSetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parameterwaarden

hObject
Afhandelen naar het object waarvoor beveiligingsgegevens moeten worden ingesteld.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

rSid
Het CSid object met de nieuwe beveiligingsgegevens.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Requirements

Koptekst: atlsecurity.h

AtlGetOwnerSid

Roep deze functie aan om de beveiligings-id (SID) van de eigenaar van een object op te halen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlGetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parameterwaarden

hObject
Greep naar het object van waaruit beveiligingsgegevens moeten worden opgehaald.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

pSid
Wijs een CSid object aan dat de nieuwe beveiligingsgegevens bevat.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Requirements

Koptekst: atlsecurity.h

AtlSetOwnerSid

Roep deze functie aan om de beveiligings-id (SID) van de eigenaar van een object in te stellen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlSetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parameterwaarden

hObject
Afhandelen naar het object waarvoor beveiligingsgegevens moeten worden ingesteld.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

rSid
Het CSid object met de nieuwe beveiligingsgegevens.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Requirements

Koptekst: atlsecurity.h

AtlGetSacl

Roep deze functie aan om de systeemtoegangsbeheerlijstgegevens (SACL) van een opgegeven object op te halen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlGetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSacl* pSacl,
    bool bRequestNeededPrivileges = true) throw(...);

Parameterwaarden

hObject
Greep naar het object van waaruit de beveiligingsgegevens moeten worden opgehaald.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

pSacl
Wijs een SACL-object aan dat de opgehaalde beveiligingsgegevens bevat.

bRequestNeededPrivileges
Indien waar, probeert de functie de SE_SECURITY_NAME-bevoegdheid in te schakelen en deze na voltooiing te herstellen.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Opmerkingen

Als AtlGetSacl het veel malen moet worden aangeroepen op veel verschillende objecten, is het efficiënter om de SE_SECURITY_NAME bevoegdheid eenmaal in te schakelen voordat de functie wordt aangeroepen, waarbij bRequestNeededPrivileges is ingesteld op false.

Requirements

Koptekst: atlsecurity.h

AtlSetSacl

Roep deze functie aan om de SACL-gegevens (System Access Control List) van een opgegeven object in te stellen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlSetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSacl& rSacl,
    DWORD dwInheritanceFlowControl = 0,
    bool bRequestNeededPrivileges = true) throw(...);

Parameterwaarden

hObject
Afhandelen naar het object waarvoor beveiligingsgegevens moeten worden ingesteld.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter hObject .

rSacl
De SACL met de nieuwe beveiligingsgegevens.

dwInheritanceFlowControl
Het beheer van de overnamestroom. Deze waarde kan 0 (de standaardinstelling), PROTECTED_SACL_SECURITY_INFORMATION of UNPROTECTED_SACL_SECURITY_INFORMATION zijn.

bRequestNeededPrivileges
Indien waar, probeert de functie de SE_SECURITY_NAME-bevoegdheid in te schakelen en deze na voltooiing te herstellen.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Opmerkingen

In builds voor foutopsporing treedt een assertiefout op als hObject ongeldig is of als dwInheritanceFlowControl geen van de drie toegestane waarden is.

Als AtlSetSacl het veel malen moet worden aangeroepen op veel verschillende objecten, is het efficiënter om de SE_SECURITY_NAME bevoegdheid eenmaal in te schakelen voordat de functie wordt aangeroepen, waarbij bRequestNeededPrivileges is ingesteld op false.

Requirements

Koptekst: atlsecurity.h

AtlGetSecurityDescriptor

Roep deze functie aan om de beveiligingsdescriptor van een bepaald object op te halen.

Belangrijk

Deze functie kan niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

inline bool AtlGetSecurityDescriptor(
    LPCTSTR pszObjectName,
    SE_OBJECT_TYPE ObjectType,
    CSecurityDesc* pSecurityDescriptor,
    SECURITY_INFORMATION requestedInfo = OWNER_SECURITY_INFORMATION |
    GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
    SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges = true) throw(...);

Parameterwaarden

pszObjectName
Aanwijzer naar een door null beëindigde tekenreeks waarmee de naam van het object wordt opgegeven waaruit beveiligingsgegevens moeten worden opgehaald.

ObjectType
Hiermee geeft u een waarde op uit de SE_OBJECT_TYPE opsomming die het type object aangeeft dat wordt geïdentificeerd door de parameter pszObjectName .

pSecurityDescriptor
Het object dat de aangevraagde beveiligingsdescriptor ontvangt.

requestedInfo
Een set SECURITY_INFORMATION bitvlaggen die aangeven welk type beveiligingsgegevens moeten worden opgehaald. Deze parameter kan een combinatie van de volgende waarden zijn.

bRequestNeededPrivileges
Indien waar, probeert de functie de SE_SECURITY_NAME-bevoegdheid in te schakelen en deze na voltooiing te herstellen.

Retourwaarde

Retourneert waar bij succes, onwaar bij mislukt.

Opmerkingen

Als AtlGetSecurityDescriptor het veel malen moet worden aangeroepen op veel verschillende objecten, is het efficiënter om de SE_SECURITY_NAME bevoegdheid eenmaal in te schakelen voordat de functie wordt aangeroepen, waarbij bRequestNeededPrivileges is ingesteld op false.

Requirements

Koptekst: atlsecurity.h

Zie ook

Functies