IADsSecurityUtility::GetSecurityDescriptor-Methode (iads.h)
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".
Dateifreigabe
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 |