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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | adshlp.h |
| Bibliothek | Activeds.lib |
| DLL | Activeds.dll |