SecurityDescriptorToBinarySD-Funktion (adshlp.h)
Die SecurityDescriptorToBinarySD-Funktion konvertiert ein IADsSecurityDescriptor-Objekt in das binäre Sicherheitsdeskriptorformat.
Syntax
HRESULT SecurityDescriptorToBinarySD(
[in] VARIANT vVarSecDes,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[out] PDWORD pdwSDLength,
[in] LPCWSTR pszServerName,
[in] LPCWSTR userName,
[in] LPCWSTR passWord,
[in] DWORD dwFlags
);
Parameter
[in] vVarSecDes
Typ: VARIANT
Enthält einen VARIANT-Wert , der den zu konvertierenden Sicherheitsdeskriptor enthält. Variant muss eine VT_DISPATCH enthalten, die ein IADsSecurityDescriptor-Objekt enthält.
[out] ppSecurityDescriptor
Typ: PSECURITY_DESCRIPTOR*
Adresse eines SECURITY_DESCRIPTOR Zeigers, der die binären Sicherheitsbeschreibungsdaten empfängt. Der Aufrufer muss diesen Arbeitsspeicher freigeben, indem er diesen Zeiger an die FreeADsMem-Funktion übergibt.
[out] pdwSDLength
Typ: PDWORD
Adresse eines DWORD-Werts , der die Länge der binären Sicherheitsdeskriptordaten in Byte empfängt.
[in] pszServerName
Typ: LPCWSTR
Eine mit NULL endende Unicode-Zeichenfolge, die den Namen des Servers angibt, auf dem der Sicherheitsdeskriptor platziert wird. Dieser Parameter ist optional und kann NULL sein.
[in] userName
Typ: LPCWSTR
Eine Unicode-Zeichenfolge mit Null-Termin, die den Benutzernamen enthält, dem der Sicherheitsdeskriptor zugeordnet ist. Dieser Parameter ist optional und kann NULL sein.
[in] passWord
Typ: LPCWSTR
Eine unicode-Zeichenfolge mit Null-Beendigung, die das Kennwort enthält, das dem Sicherheitsdeskriptor zugeordnet ist. 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 die standardmäßigen Rückgabewerte sowie folgendes.
Hinweise
Diese Funktion wird für Legacyanwendungen verwendet, um Sicherheitsdeskriptoren manuell in binäre Sicherheitsdeskriptoren zu konvertieren. Verwenden Sie für neue Anwendungen IADsSecurityUtility, 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 |