DSCreateSecurityPage-Funktion (dssec.h)
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 |
|---|---|
|
Die Sicherheitseigenschaften sind schreibgeschützt. |
|
Es wird keine Zugriffsüberprüfung durchgeführt. |
|
Die SACL-Eigenschaft ( System Access Control List ) ist schreibgeschützt. |
|
Die Eigenschaft des Objektbesitzers ist schreibgeschützt. |
|
Das -Objekt ist ein Stammobjekt. |
|
Wenden Sie keine Filter an. |
|
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 |