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

Weitere Informationen

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility