TreeResetNamedSecurityInfoA-Funktion (aclapi.h)

Diese Version dieser Funktion wird nicht unterstützt. Die Breitzeichenversion dieser Funktion, TreeResetNamedSecurityInfoW, wird unterstützt.

Syntax

DWORD TreeResetNamedSecurityInfoA(
  [in]           LPSTR                pObjectName,
  [in]           SE_OBJECT_TYPE       ObjectType,
  [in]           SECURITY_INFORMATION SecurityInfo,
  [in, optional] PSID                 pOwner,
  [in, optional] PSID                 pGroup,
  [in, optional] PACL                 pDacl,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 KeepExplicit,
  [in, optional] FN_PROGRESS          fnProgress,
  [in]           PROG_INVOKE_SETTING  ProgressInvokeSetting,
  [in, optional] PVOID                Args
);

Parameter

[in] pObjectName

Zeiger auf eine NULL-Zeichenfolge, die den Namen des Stammknotenobjekts für die Objekte angibt, die aktualisierte Sicherheitsinformationen empfangen sollen. Unterstützte Objekte sind Registrierungsschlüssel und Dateiobjekte. Beschreibungen der Zeichenfolgenformate für die verschiedenen Objekttypen finden Sie unter SE_OBJECT_TYPE.

[in] ObjectType

Ein Wert der SE_OBJECT_TYPE-Enumeration , der den Typ des Objekts mit dem pObjectName-Parameter angibt. Die unterstützten Werte sind SE_REGISTRY_KEY und SE_FILE_OBJECT für Registrierungsschlüssel bzw. Dateiobjekte.

[in] SecurityInfo

Eine Reihe von Bitflags, die den Typ der zurückzusetzenden Sicherheitsinformationen angeben. Dieser Parameter kann eine Kombination der SECURITY_INFORMATION Bitflags sein.

[in, optional] pOwner

Ein Zeiger auf eine SID-Struktur , die den Besitzer des Objekts identifiziert. Die SID muss eine sein, die als Besitzer-SID einer Sicherheitsbeschreibung zugewiesen werden kann. Der SecurityInfo-Parameter muss das OWNER_SECURITY_INFORMATION-Flag enthalten. Um den Besitzer festzulegen, muss der Aufrufer WRITE_OWNER Zugriff auf jedes Objekt haben, einschließlich des Stammobjekts. Wenn Sie die Besitzer-SID nicht festlegen, kann dieser Parameter NULL sein.

[in, optional] pGroup

Ein Zeiger auf eine SID-Struktur , die die primäre Gruppe des Objekts identifiziert. Der SecurityInfo-Parameter muss das GROUP_SECURITY_INFORMATION-Flag enthalten. Um die Gruppe festzulegen, muss der Aufrufer WRITE_OWNER Zugriff auf jedes Objekt haben, einschließlich des Stammobjekts. Wenn Sie die primäre Gruppen-SID nicht festlegen, kann dieser Parameter NULL sein.

[in, optional] pDacl

Ein Zeiger auf eine ACL-Struktur ( Access Control List ), die die neue DACL für die zurückgesetzten Objekte darstellt. Der SecurityInfo-Parameter muss das flag DACL_SECURITY_INFORMATION enthalten. Der Aufrufer muss READ_CONTROL und WRITE_DAC Zugriff auf jedes Objekt haben, einschließlich des Stammobjekts. Wenn Sie die DACL nicht festlegen, kann dieser Parameter NULL sein.

[in, optional] pSacl

Ein Zeiger auf eine ACL-Struktur, die die neue SACL für die zurückgesetzten Objekte darstellt. Der SecurityInfo-Parameter muss eines der folgenden Flags enthalten: SACL_SECURITY_INFORMATION, LABEL_SECURITY_INFORMATION, ATTRIBUTE_SECURITY_INFORMATION, SCOPE_SECURITY_INFORMATION oder BACKUP_SECURITY_INFORMATION. Wenn Sie SACL_SECURITY_INFORMATION oder SCOPE_SECURITY_INFORMATION festlegen, muss das SE_SECURITY_NAME-Recht für den Aufrufer aktiviert sein. Wenn Sie die SACL nicht festlegen, kann dieser Parameter NULL sein.

[in] KeepExplicit

Boolescher Wert, der definiert, ob explizit definierte ACEs für die Unterstruktur beibehalten oder gelöscht werden. Wenn KeepExplicitTRUE ist, werden explizit definierte ACEs für jede Dacl- und SACL-Unterstruktur beibehalten, und geerbte ACEs werden durch die geerbten ACEs von pDacl und pSacl ersetzt. Wenn KeepExplicitFALSE ist, werden explizit definierte ACEs für jede Dacl und SACL-Unterstruktur gelöscht, bevor die geerbten ACEs durch die geerbten ACEs von pDacl und pSacl ersetzt werden.

[in, optional] fnProgress

Ein Zeiger auf die Funktion, die verwendet wird, um den Fortschritt der TreeResetNamedSecurityInfo-Funktion nachzuverfolgen. Der Prototyp der Fortschrittsfunktion ist:

#include <windows.h>
#include <Aclapi.h>

typedef VOID (*FN_PROGRESS) (
  IN LPWSTR pObjectName,              // Name of object just processed
  IN DWORD Status,                    // Status of operation on object
  IN OUT PPROG_INVOKE_SETTING pInvokeSetting, // When to set
  IN PVOID Args,                      // Caller specific data
  IN BOOL SecuritySet                 // Whether security was set
);

Die Statusfunktion stellt dem Aufrufer Fortschritts- und Fehlerinformationen bereit, wenn Knoten verarbeitet werden. Der Aufrufer gibt die Statusfunktion in fnProgress an, und während des Strukturvorgangs übergibt TreeResetNamedSecurityInfo den Namen des zuletzt verarbeiteten Objekts, den Fehler status dieses Vorgangs und den aktuellen PROG_INVOKE_SETTING Wert. Der Aufrufer kann den wert der PROG_INVOKE_SETTING mithilfe von pInvokeSetting ändern.

Wenn keine Statusfunktion verwendet werden soll, legen Sie diesen Parameter auf NULL fest.

[in] ProgressInvokeSetting

Ein Wert der PROG_INVOKE_SETTING-Enumeration , der die anfängliche Einstellung für die Statusfunktion angibt.

[in, optional] Args

Ein Zeiger auf die vom Aufrufer angegebenen VOID for progress-Funktionsargumente.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, gibt sie einen in WinError.h definierten Fehlercode zurück.

Hinweise

Das Festlegen eines NULL-Besitzers , einer Gruppe, einer DACL oder einer SACL wird von dieser Funktion nicht unterstützt.

Wenn der Aufrufer nicht die richtigen Berechtigungen und Berechtigungen enthält, um die angeforderten Besitzer-, Gruppen-, DACL- und SACL-Updates zu unterstützen, wird keines der Updates ausgeführt.

Diese Funktion ähnelt der TreeSetNamedSecurityInfo-Funktion :

• Wenn der KeepExplicit-Parameter von TreeResetNamedSecurityInfo auf TRUE festgelegt ist, entspricht die Funktion TreeSetNamedSecurityInfo , wobei der dwAction-Parameter auf TREE_SEC_INFO_RESET_KEEP_EXPLICIT festgelegt ist.
• Wenn der KeepExplicit-Parameter von TreeResetNamedSecurityInfo auf FALSE festgelegt ist, entspricht die Funktion TreeSetNamedSecurityInfo , wobei der dwAction-Parameter auf TREE_SEC_INFO_RESET festgelegt ist.

Anforderungen