NetGetJoinableOUs: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: Diese Funktion ermittelt eine Liste von Organisationseinheiten(OU) in einem Actice Directory, in welcher der Aufrufer ein Computerkonto erstellen darf. <pre> Declare F...)
 
Zeile 1: Zeile 1:
 
Diese Funktion ermittelt eine Liste von Organisationseinheiten(OU) in einem Actice Directory, in welcher der Aufrufer ein Computerkonto erstellen darf.
 
Diese Funktion ermittelt eine Liste von Organisationseinheiten(OU) in einem Actice Directory, in welcher der Aufrufer ein Computerkonto erstellen darf.
  
<pre>
+
<code vb>
 
Declare Function NetGetJoinableOUs Lib "NetApi32" ( _
 
Declare Function NetGetJoinableOUs Lib "NetApi32" ( _
 
                             ByVal lpServername As Long, _
 
                             ByVal lpServername As Long, _
Zeile 9: Zeile 9:
 
                             ByRef OUCount as long, _
 
                             ByRef OUCount as long, _
 
                             ByRef lpOUs As Long) As Long
 
                             ByRef lpOUs As Long) As Long
</pre>
+
</code>
  
  
'''Parameter:'''
+
==Parameter==
  
 
''lpServername''
 
''lpServername''
Zeile 27: Zeile 27:
 
''lpAccount''
 
''lpAccount''
  
:Zeiger auf ein Unicodestring, der ein Benutzername enthält, welcher beim Zugriff auf den Domain Controller benutzt werden soll. Der Benutzername kann den NetBios Name der Domain und der NT Anmeldename sein ( also "Domain\Username" ) oder ein UPN sein ( also "Username@Domain.com" ).
+
:Zeiger auf ein Unicodestring, der ein Benutzername enthält, welcher beim Zugriff auf den Domain Controller benutzt werden soll. Der Benutzername kann den NetBios Name der Domain und der NT Anmeldename sein (also "Domain\Username") oder ein UPN sein (also "Username@Domain.com").
 
:Dieser Parameter darf [[NULL]] sein, dann wird der Benutzerkontext des Aufrufers verwendet.
 
:Dieser Parameter darf [[NULL]] sein, dann wird der Benutzerkontext des Aufrufers verwendet.
 
:Übergabe mit StrPtr() empfohlen.
 
:Übergabe mit StrPtr() empfohlen.
Zeile 48: Zeile 48:
  
  
'''Rückgabewert(e):'''
+
==Rückgabe==
  
 
Die Funktion gibt einen Statuswert zurück, der einen Fehlerwert darstellt.  
 
Die Funktion gibt einen Statuswert zurück, der einen Fehlerwert darstellt.  
Ist kein Fehler aufgetreten, so gibt die Funktion ''NERR_SUCCESS = 0'' zurück. Eine erweiterte Auflistung der Fehlercodes finden Sie in der [http://msdn2.microsoft.com/en-us/library/ms681381.aspx MSDN].
+
Ist kein Fehler aufgetreten, so gibt die Funktion [[NERR_SUCCESS]] = 0 zurück. Eine erweiterte Auflistung der Fehlercodes finden Sie in der [http://msdn2.microsoft.com/en-us/library/ms681381.aspx MSDN].
  
  
'''Sonstige Hinweise:'''
+
==Hinweise==
  
 
Diese Funktion der NetApi ist erst ab Windows 2000 verfügbar, auf Windows 9x ist sie nicht unterstützt.
 
Diese Funktion der NetApi ist erst ab Windows 2000 verfügbar, auf Windows 9x ist sie nicht unterstützt.
  
 +
[[Kategorie:Internet und Netzwerke]]
 
[[Kategorie:NetApi]]
 
[[Kategorie:NetApi]]

Version vom 13. Mai 2008, 10:43 Uhr

Diese Funktion ermittelt eine Liste von Organisationseinheiten(OU) in einem Actice Directory, in welcher der Aufrufer ein Computerkonto erstellen darf.

Declare Function NetGetJoinableOUs Lib "NetApi32" ( _

                           ByVal lpServername As Long, _
                           ByVal lpDomainname As Long,  _
                           ByVal lpAccount As Long, _
                           ByVal lpPassword As Long, _
                           ByRef OUCount as long, _
                           ByRef lpOUs As Long) As Long


Parameter

lpServername

Zeiger auf einen Unicodestring, der einen Computernamen enthält, welcher die Ermittlung durchführen soll.
Dieser Parameter darf NULL sein, dann wird der eigene Computer zur Ermittlung benutzt.
Übergabe mit StrPtr() empfohlen.

lpDomainname

Zeiger auf einen Unicodestring, der einen Domainname enthält.
Übergabe mit StrPtr() empfohlen.

lpAccount

Zeiger auf ein Unicodestring, der ein Benutzername enthält, welcher beim Zugriff auf den Domain Controller benutzt werden soll. Der Benutzername kann den NetBios Name der Domain und der NT Anmeldename sein (also "Domain\Username") oder ein UPN sein (also "Username@Domain.com").
Dieser Parameter darf NULL sein, dann wird der Benutzerkontext des Aufrufers verwendet.
Übergabe mit StrPtr() empfohlen.

lpPassword

Zeiger auf ein Unicodestring, der das passende Benutzerkennwort enthält.
Dieser Parameter muss NULL sein, wenn lpAccount ebenfalls NULL ist.
Übergabe mit StrPtr() empfohlen.

OUCount

Zeiger auf eine Variable vom Typ Long, in der die Anzahl von OUs gespeichert werden kann.

lpOUs

Zeiger auf eine Variable vom Typ Long, welche den Zeiger auf den Rückgabepuffer aufnehmen kann.
Der zurückgegebene Zeiger muss mittels NetApiBufferFree wieder freigegeben werden.
Der Rückgabepuffer ist ein Array Zeigern auf Unicodestrings mit den OUs in der ein Computerkonto erstellt werden kann.


Rückgabe

Die Funktion gibt einen Statuswert zurück, der einen Fehlerwert darstellt. Ist kein Fehler aufgetreten, so gibt die Funktion NERR_SUCCESS = 0 zurück. Eine erweiterte Auflistung der Fehlercodes finden Sie in der MSDN.


Hinweise

Diese Funktion der NetApi ist erst ab Windows 2000 verfügbar, auf Windows 9x ist sie nicht unterstützt.