IADsSecurityUtility::ConvertSecurityDescriptor-Methode (iads.h)
Die ConvertSecurityDescriptor-Methode konvertiert einen Sicherheitsdeskriptor aus einem Format in ein anderes.
Syntax
HRESULT ConvertSecurityDescriptor(
[in] VARIANT varSD,
[in] long lDataFormat,
[in] long lOutFormat,
[out] VARIANT *pResult
);
Parameter
[in] varSD
Ein VARIANT-Wert , der den zu konvertierenden Sicherheitsdeskriptor enthält. Das Format dieses VARIANT wird durch den lDataFormat-Parameter definiert.
[in] lDataFormat
Enthält einen der ADS_SD_FORMAT_ENUM-Werte , der das Format des Sicherheitsdeskriptors im varSD-Parameter angibt. In der folgenden Liste werden die möglichen Werte für diesen Parameter und das Format des varSD-Parameters angegeben.
ADS_SD_FORMAT_IID
varSD enthält eine VT_DISPATCH , die für die IADsSecurityDescriptor-Schnittstelle abgefragt werden kann.
ADS_SD_FORMAT_RAW
varSD enthält eine VT_I1 | VT_ARRAY , die den Sicherheitsdeskriptor im Rohdatenformat enthält. Dies hat das Format einer SECURITY_DESCRIPTOR-Struktur .
ADS_SD_FORMAT_HEXSTRING
varSD enthält eine VT_BSTR , die den unformatierten Sicherheitsdeskriptor im hexadezimalen Zeichenfolgenformat enthält.
[in] lOutFormat
Enthält einen der ADS_SD_FORMAT_ENUM-Werte , der das Format angibt, in das der Sicherheitsdeskriptor konvertiert werden soll. In der folgenden Liste werden die möglichen Werte für diesen Parameter und das Format des pvResult-Parameters angegeben.
ADS_SD_FORMAT_IID
pvResult empfängt eine VT_DISPATCH , die für die IADsSecurityDescriptor-Schnittstelle abgefragt werden kann.
ADS_SD_FORMAT_RAW
pvResult 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
pvResult empfängt eine VT_BSTR , die den unformatierten Sicherheitsdeskriptor im hexadezimalen Zeichenfolgenformat enthält.
[out] pResult
Zeiger auf einen VARIANT-Wert , der den konvertierten Sicherheitsdeskriptor empfängt. Das Format des abgerufenen Sicherheitsdeskriptors wird durch den lOutFormat-Parameter angegeben.
Rückgabewert
Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein COM- oder Win32-Fehlercode. Mögliche Fehlercodes sind:
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |