DSCreateISecurityInfoObjectEx-Funktion (dssec.h)

Artikel
08/23/2023

Die DSCreateISecurityInfoObjectEx-Funktion erstellt eine instance der ISecurityInformation-Schnittstelle, die dem angegebenen Verzeichnisdienstobjekt (DS) auf dem angegebenen Server zugeordnet ist.

Syntax

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parameter

[in] pwszObjectPath

Der vollständige Pfad des DS-Objekts, für das eine instance der ISecurityInformation-Schnittstelle erstellt werden soll.

[in] pwszObjectClass

Die Klasse des Durch den pwszObjectPath-Parameter angegebenen Objekts.

[in] pwszServer

Der Server des durch den pwszObjectPath-Parameter angegebenen Objekts. Wenn der Wert dieses Parameters NULL ist, wird der Server aus dem Pfad abgerufen, der durch den pwszObjectPath-Parameter angegeben wird.

[in] pwszUserName

Ein Benutzername, der dem neuen ISecurityInformation-Objekt zugeordnet werden soll. Wenn der Wert dieses Parameters NULL ist, wird die Standardeinstellung Active Directory Services Interfaces (ADSI) verwendet.

[in] pwszPassword

Ein Kennwort, das dem neuen ISecurityInformation-Objekt zugeordnet werden soll. Wenn der Wert dieses Parameters NULL ist, wird die Standardeinstellung Active Directory Services Interfaces (ADSI) verwendet.

[in] dwFlags

Flags, die für die Seite mit den Sicherheitseigenschaften verwendet werden, die dem neuen instance der ISecurityInformation-Schnittstelle zugeordnet ist. Dieser Parameter kann 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] ppSI

Ein Zeiger auf die instance der ISecurityInformation-Schnittstelle, die von dieser Funktion erstellt wird.

[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 DSCreateISecurityInfoObject die Funktion auf, auf die pfnReadSD verweist, 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 DSCreateISecurityInfoObject die Funktion auf, auf die von pfnWriteSD verwiesen wird, um den Sicherheitsdeskriptor des Objekts zu schreiben.

[in] lpContext

Kontext, der an die Funktionen übergeben werden soll, die durch die Parameter pfnReadSD und pfnWriteSD identifiziert werden.

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.

Anforderungen


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