DSCreateSecurityPage-Funktion (dssec.h)

Artikel
08/23/2023

Die DSCreateSecurityPage-Funktion erstellt eine Sicherheitseigenschaftenseite für ein Active Directory-Objekt. Die resultierende Eigenschaftenseite kann einem Eigenschaftenblatt hinzugefügt werden.

Syntax

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parameter

[in] pwszObjectPath

Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die den vollständigen Active Directory-Pfad für das -Objekt darstellt.

[in, optional] pwszObjectClass

Ein Zeiger auf eine mit NULL endende Breitzeichenzeichenfolge, die die Objektklasse darstellt. Dieser Wert kann NULL sein.

[in] dwFlags

Flags, die für die Seite mit den Sicherheitseigenschaften verwendet werden. Dieser Parameter kann keine oder eine beliebige Kombination der folgenden Flags sein.

Wert	Bedeutung
DSSI_READ_ONLY 0x00000001	Die Sicherheitseigenschaften sind schreibgeschützt.
DSSI_NO_ACCESS_CHECK 0x00000002	Es wird keine Zugriffsüberprüfung durchgeführt.
DSSI_NO_EDIT_SACL 0x00000004	Die SACL-Eigenschaft ( System Access Control List ) ist schreibgeschützt.
DSSI_NO_EDIT_OWNER 0x00000008	Die Eigenschaft des Objektbesitzers ist schreibgeschützt.
DSSI_IS_ROOT 0x00000010	Das -Objekt ist ein Stammobjekt.
DSSI_NO_FILTER 0x00000020	Wenden Sie keine Filter an.
DSSI_NO_READONLY_MESSAGE 0x00000040	Unterdrücken schreibgeschützter Popupmeldungen.

[out] phPage

Ein Zeiger auf eine HPROPSHEETPAGE , die die erstellte Sicherheitseigenschaftenseite zurückgibt.

[in, optional] pfnReadSD

Ein Zeiger auf eine Funktion, die zum Lesen des Sicherheitsdeskriptors des Objekts verwendet wird. Dieser Wert kann NULL sein. Wenn pfnReadSD nicht NULL ist, ruft DSCreateSecurityPage die Funktion auf, auf die von pfnReadSD verwiesen wird, um den Sicherheitsdeskriptor des Objekts abzurufen.

[in, optional] pfnWriteSD

Ein Zeiger auf eine Funktion, die zum Schreiben des Sicherheitsdeskriptors des Objekts verwendet wird. Dieser Wert kann NULL sein. Wenn pfnWriteSD nicht NULL ist, ruft DSCreateSecurityPage die Funktion auf, auf die von pfnWriteSD verwiesen wird, um den Sicherheitsdeskriptor des Objekts zu schreiben.

[in] lpContext

Kontext, der an die durch pfnReadSD oder pfnWriteSD identifizierten Funktionen übergeben werden soll.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Die Funktion, auf die von pfnReadSD verwiesen wird, wird wie folgt definiert.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

Die DSCreateSecurityPage-Funktion gibt den Sicherheitsdeskriptor frei, der im dritten Parameter oben durch einen Aufruf der LocalFree-Funktion zurückgegeben wird.

Die Funktion, auf die von pfnWriteSD verwiesen wird, wird wie folgt definiert.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dssec.h
Bibliothek	DSSec.lib
DLL	DSSec.dll

Weitere Informationen

Eigenschaftenseite "Basic Security"

ISecurityInformation

Share via