ConvertStringSecurityDescriptorToSecurityDescriptor: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K (Rückgabe)
Zeile 3: Zeile 3:
 
Die Funktion [[ConvertStringSecurityDescriptorToSecurityDescriptor]] konvertiert einen [[SECURITY_DESCRIPTOR]] in Textform in die binäre Form. Um die binäre Form wieder in einen [[SECURITY_DESCRIPTOR]] der Textform zurückzuwandeln kann die Funktion [[ConvertSecurityDescriptorToStringSecurityDescriptor]] verwendet werden.
 
Die Funktion [[ConvertStringSecurityDescriptorToSecurityDescriptor]] konvertiert einen [[SECURITY_DESCRIPTOR]] in Textform in die binäre Form. Um die binäre Form wieder in einen [[SECURITY_DESCRIPTOR]] der Textform zurückzuwandeln kann die Funktion [[ConvertSecurityDescriptorToStringSecurityDescriptor]] verwendet werden.
  
<vb>
+
<<syntaxhighlight lang="vb">>
 
Private Declare Function ConvertStringSecurityDescriptorToSecurityDescriptorA Lib "ADVAPI32.dll" ( _
 
Private Declare Function ConvertStringSecurityDescriptorToSecurityDescriptorA Lib "ADVAPI32.dll" ( _
 
     ByVal StringSecurityDescriptor As String, ByVal StringSDRevision As Long, _
 
     ByVal StringSecurityDescriptor As String, ByVal StringSDRevision As Long, _
Zeile 11: Zeile 11:
 
     ByVal StringSecurityDescriptor As Long, ByVal StringSDRevision As Long, _
 
     ByVal StringSecurityDescriptor As Long, ByVal StringSDRevision As Long, _
 
     ByRef lpSecurityDescriptor As Long, ByRef lpSecurityDescriptorLen As Long) As Long
 
     ByRef lpSecurityDescriptor As Long, ByRef lpSecurityDescriptorLen As Long) As Long
</vb>
+
</<syntaxhighlight lang="vb">>
  
 
==Parameter==
 
==Parameter==
Zeile 25: Zeile 25:
 
==Rückgabe==
 
==Rückgabe==
 
Wenn die Funktion erfolgreich war, so ist der Rückgabewert ungleich 0. Andernfalls ist ein Fehler aufgetreten, die Fehlernummer kann mit [[Err.LastDLLError]] ermittelt werden.
 
Wenn die Funktion erfolgreich war, so ist der Rückgabewert ungleich 0. Andernfalls ist ein Fehler aufgetreten, die Fehlernummer kann mit [[Err.LastDLLError]] ermittelt werden.
<vb>Const ERROR_UNKNOWN_REVISION As Long = 1305&
+
<<syntaxhighlight lang="vb">>Const ERROR_UNKNOWN_REVISION As Long = 1305&
 
Const ERROR_NONE_MAPPED As Long = 1332&
 
Const ERROR_NONE_MAPPED As Long = 1332&
 
Const ERROR_INVALID_PARAMETER As Long = 87&
 
Const ERROR_INVALID_PARAMETER As Long = 87&
</vb>
+
</<syntaxhighlight lang="vb">>
  
 
==Hinweise==
 
==Hinweise==
Zeile 34: Zeile 34:
  
 
==Beispiel==
 
==Beispiel==
<vb></vb>
+
<<syntaxhighlight lang="vb">></<syntaxhighlight lang="vb">>
  
 
==Betriebssystem==
 
==Betriebssystem==

Version vom 5. November 2016, 23:09 Uhr

Die Funktion ConvertStringSecurityDescriptorToSecurityDescriptor konvertiert einen SECURITY_DESCRIPTOR in Textform in die binäre Form. Um die binäre Form wieder in einen SECURITY_DESCRIPTOR der Textform zurückzuwandeln kann die Funktion ConvertSecurityDescriptorToStringSecurityDescriptor verwendet werden.

<<syntaxhighlight lang="vb">> Private Declare Function ConvertStringSecurityDescriptorToSecurityDescriptorA Lib "ADVAPI32.dll" ( _

   ByVal StringSecurityDescriptor As String, ByVal StringSDRevision As Long, _
   ByRef lpSecurityDescriptor As Long, ByRef lpSecurityDescriptorLen As Long) As Long

Private Declare Function ConvertStringSecurityDescriptorToSecurityDescriptorW Lib "ADVAPI32.dll" ( _

   ByVal StringSecurityDescriptor As Long, ByVal StringSDRevision As Long, _
   ByRef lpSecurityDescriptor As Long, ByRef lpSecurityDescriptorLen As Long) As Long

</<syntaxhighlight lang="vb">>

Parameter

StringSecurityDescriptor

[in] bezeichnet einen Zeiger auf die Textform eines Security Descriptor

StringSDRevision

[in] Der einzig erlaubte Wert ist SDDL_REVISION_1

lpSecurityDescriptor

[out] bezeichnet eine Variable, welche den Zeiger auf den SECURITY_DESCRIPTOR in binärer Form aufnehmen kann. Um den zurückgegebenen Speicher wieder freizugeben muss die Funktion LocalFree benutzt werden.

lpSecurityDescriptorLen

[out] bezeichnet eine Variable, welche die Größe des SECURITY_DESCRIPTOR in seiner binären Form beschreibt.

Rückgabe

Wenn die Funktion erfolgreich war, so ist der Rückgabewert ungleich 0. Andernfalls ist ein Fehler aufgetreten, die Fehlernummer kann mit Err.LastDLLError ermittelt werden. <<syntaxhighlight lang="vb">>Const ERROR_UNKNOWN_REVISION As Long = 1305& Const ERROR_NONE_MAPPED As Long = 1332& Const ERROR_INVALID_PARAMETER As Long = 87& </<syntaxhighlight lang="vb">>

Hinweise

Die Funktion steht auch als UNICODE Version auf NT basierenden Systemen zur Verfügung und sollte auf diesen auch benutzt werden.

Beispiel

<<syntaxhighlight lang="vb">></<syntaxhighlight lang="vb">>

Betriebssystem

Die API-Funktion ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows 2000 oder höher

Verwandte Funktionen

Weblinks

MSDN Library: ConvertStringSecurityDescriptorToSecurityDescriptor