IADsSecurityUtility::GetSecurityDescriptor-Methode (iads.h)

Artikel
08/24/2023

Die GetSecurityDescriptor-Methode ruft einen Sicherheitsdeskriptor für die angegebene Datei, Dateifreigabe oder den angegebenen Registrierungsschlüssel ab.

Syntax

HRESULT GetSecurityDescriptor(
  [in]  VARIANT varPath,
  [in]  long    lPathFormat,
  [in]  long    lFormat,
  [out] VARIANT *pVariant
);

Parameter

[in] varPath

Eine VARIANT-Zeichenfolge , die den Pfad des Objekts enthält, für das die Sicherheitsbeschreibung abgerufen werden soll.

Datei

Eine gültige Dateipfadsyntax. Beispiel: "c:\specs\public\adxml.doc" oder "\adsi\public\dsclient.exe".

Eine gültige Dateipfadsyntax für eine Dateifreigabe. Beispiel: "\adsi\public".

Registrierungsschlüssel

Eine gültige Registrierungssyntax. Beispiel: "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".

[in] lPathFormat

Enthält einen der ADS_PATHTYPE_ENUM-Werte , der das Format des varPath-Parameters angibt.

[in] lFormat

Enthält einen der ADS_SD_FORMAT_ENUM-Werte , der das Format des Sicherheitsdeskriptors angibt, der im pVariant-Parameter zurückgegeben wird. Die folgende Liste identifiziert die möglichen Werte für diesen Parameter und das Format, das im pVariant-Parameter angegeben wird.

ADS_SD_FORMAT_IID

pVariant empfängt eine VT_DISPATCH , die für die IADsSecurityDescriptor-Schnittstelle abgefragt werden kann.

ADS_SD_FORMAT_RAW

pVariant empfängt eine VT_I1 | VT_ARRAY , die den Sicherheitsdeskriptor im Rohdatenformat enthält. Dies hat das Format einer SECURITY_DESCRIPTOR-Struktur .

ADS_SD_FORMAT_HEXSTRING

pVariant empfängt eine VT_BSTR , die den unformatierten Sicherheitsdeskriptor im Zeichenfolgenformat hex codiert enthält.

[out] pVariant

Zeiger auf einen VARIANT-Wert , der die zurückgegebene Sicherheitsbeschreibung empfängt. Das Format des abgerufenen Sicherheitsdeskriptors wird durch den lFormat-Parameter angegeben.

Rückgabewert

Gibt S_OK zurück, falls erfolgreich oder andernfalls ein COM- oder Win32-Fehlercode. Mögliche Fehlercodes sind:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll