BinarySDToSecurityDescriptor-Funktion (adshlp.h)

Die BinarySDToSecurityDescriptor-Funktion konvertiert einen binären Sicherheitsdeskriptor in ein IADsSecurityDescriptor-Objekt .

Syntax

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parameter

[in] pSecurityDescriptor

Typ: PSECURITY_DESCRIPTOR

Adresse einer zu konvertierenden SECURITY_DESCRIPTOR-Struktur .

[out] pVarsec

Typ: VARIANT*

Adresse eines VARIANT-Objekts , das das Objekt empfängt. Variant enthält ein VT_DISPATCH-Objekt, das für die IADsSecurityDescriptor-Schnittstelle abgefragt werden kann. Der Aufrufer muss diesen VARIANT-Wert freigeben, indem er variant an die VariantClear-Funktion übergibt.

[in] pszServerName

Typ: LPCWSTR

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Servers angibt, von dem der Sicherheitsdeskriptor abgerufen wurde. Dieser Parameter ist optional und kann NULL sein.

[in] userName

Typ: LPCWSTR

Eine unicode-Zeichenfolge mit Null-Endung, die den Benutzernamen bereitstellt, der dem Sicherheitsdeskriptor zugeordnet werden soll. Dieser Parameter ist optional und kann NULL sein.

[in] passWord

Typ: LPCWSTR

Eine unicode-Zeichenfolge mit Null-Beendigung, die das Kennwort bereitstellt, das dem Sicherheitsdeskriptor zugeordnet werden soll. Dieser Parameter ist optional und kann NULL sein.

[in] dwFlags

Art: DWORD

Enthält Authentifizierungsflags für die Konvertierung. Dies kann null oder eine Kombination aus einem oder mehreren der ADS_AUTHENTICATION_ENUM-Enumerationswerte sein.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt standardmäßige Rückgabewerte sowie Folgendes:

Wenn der Vorgang fehlschlägt, wird ein ADSI-Fehlercode zurückgegeben. Weitere Informationen finden Sie unter ADSI-Fehlercodes.

Hinweise

Diese Funktion wird für Legacyanwendungen verwendet, die Sicherheitsdeskriptoren manuell in binäre Sicherheitsdeskriptoren konvertieren müssen. Verwenden Sie für neue Anwendungen die IADsSecurityUtility-Schnittstelle , die diese Konvertierung automatisch ausführt.

Anforderungen

Weitere Informationen

ADSI-Fehlercodes

ADSI-Funktionen

ADS_AUTHENTICATION_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SecurityDescriptorToBinarySD

VariantClear