NetLocalGroupDel: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
(Parameter:)
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
__NOTOC__
 
__NOTOC__
===== =====
+
Die API-Funktion [[NetLocalGroupDel]] löscht eine existierende lokale Benutzergruppe.
Die API-Funktion '''NetLocalGroupDel''' löscht eine existierende lokale Benutzergruppe.
 
  
<pre>
+
<syntaxhighlight lang="vb">
 
Declare Function NetLocalGroupDel Lib "netapi32.dll" ( _
 
Declare Function NetLocalGroupDel Lib "netapi32.dll" ( _
 
                 ByVal lpwServerName As Long, _
 
                 ByVal lpwServerName As Long, _
 
                 ByVal lpwGroupName As Long) As Long
 
                 ByVal lpwGroupName As Long) As Long
</pre>
+
</syntaxhighlight>
  
=====Parameter:=====
+
==Parameter==
 
''lpwServerName''
 
''lpwServerName''
 
:[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert die gelöscht werden soll.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet.
 
:[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert die gelöscht werden soll.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet.
Zeile 15: Zeile 14:
 
:[in] Zeiger auf einen Unicode String der den Namen der zu löschenden Gruppe angibt.
 
:[in] Zeiger auf einen Unicode String der den Namen der zu löschenden Gruppe angibt.
  
=====Rückgabe(n):=====
+
==Rückgaben==
War die Funktion erfolgreich, so erfolgt eine Rückgabe des Wertes 0 (NERR_Success).
+
War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success).<br>Andere mögliche Rückgabewerte sind:<br>ERROR_ACCESS_DENIED (Zugriff verweigert),<br>NERR_InvalidComputer (falscher Computername im Parameter lpwServerName),<br>NERR_NotPrimary (bei dem im Parameter lpwServerName übergebenen Computernamen handelt es sich nicht um den Primären Domaincontroller) oder<br>NERR_GroupNotFound (die zu löschende Gruppe wurde nicht gefunden)
Andere mögliche Rückgabewerte sind:<br>ERROR_ACCESS_DENIED (Zugriff verweigert),<br>NERR_InvalidComputer (falscher Computername im Parameter lpwServerName),<br>NERR_NotPrimary (bei dem im Parameter lpwServerName übergebenen Computernamen handelt es sich nicht um den Primären Domaincontroller) oder<br>NERR_GroupNotFound (die zu löschende Gruppe wurde nicht gefunden)
 
  
=====Beispiel:=====
+
==Hinweise==
nicht verfügbar
 
 
 
=====Hinweise:=====
 
 
Beachten Sie, dass die Funktion nur als Unicode Funktion implementiert ist. Um die von VB automatisch durchgeführte Umwandlung von String Parametern in ANSI Strings zu unterbinden sind die Parameter 'As Long' deklariert und müssen mit StrPtr(MyString) übergeben werden.
 
Beachten Sie, dass die Funktion nur als Unicode Funktion implementiert ist. Um die von VB automatisch durchgeführte Umwandlung von String Parametern in ANSI Strings zu unterbinden sind die Parameter 'As Long' deklariert und müssen mit StrPtr(MyString) übergeben werden.
  
=====Betriebssystem:=====
+
==Betriebssystem==
Die API-Funktion '''NetLocalGroupDel''' ist unter folgenden Betriebssystemen funktionsfähig:
+
Die API-Funktion [[NetLocalGroupDel]] ist unter folgenden Betriebssystemen funktionsfähig:
  
 
*Windows NT 3.1 oder später
 
*Windows NT 3.1 oder später
  
=====Verweise:=====
+
==Verweise==
 
*[[NetGroupDel]]
 
*[[NetGroupDel]]
 
*[[NetLocalGroupAdd]]
 
*[[NetLocalGroupAdd]]
 
*[[NetGroupAdd]]
 
*[[NetGroupAdd]]
  
 +
[[Kategorie:Internet und Netzwerke]]
 +
[[Kategorie:Lokale Gruppen]]
 
[[Kategorie:NetApi]]
 
[[Kategorie:NetApi]]

Aktuelle Version vom 7. Oktober 2016, 21:24 Uhr

Die API-Funktion NetLocalGroupDel löscht eine existierende lokale Benutzergruppe.

Declare Function NetLocalGroupDel Lib "netapi32.dll" ( _
                 ByVal lpwServerName As Long, _
                 ByVal lpwGroupName As Long) As Long

Parameter

lpwServerName

[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert die gelöscht werden soll.
Der Rechnername muss mit "\\" beginnen.
Wird für diesen Parameter NULL übergeben, wird der lokale Computer verwendet.

lpwGroupName

[in] Zeiger auf einen Unicode String der den Namen der zu löschenden Gruppe angibt.

Rückgaben

War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success).
Andere mögliche Rückgabewerte sind:
ERROR_ACCESS_DENIED (Zugriff verweigert),
NERR_InvalidComputer (falscher Computername im Parameter lpwServerName),
NERR_NotPrimary (bei dem im Parameter lpwServerName übergebenen Computernamen handelt es sich nicht um den Primären Domaincontroller) oder
NERR_GroupNotFound (die zu löschende Gruppe wurde nicht gefunden)

Hinweise

Beachten Sie, dass die Funktion nur als Unicode Funktion implementiert ist. Um die von VB automatisch durchgeführte Umwandlung von String Parametern in ANSI Strings zu unterbinden sind die Parameter 'As Long' deklariert und müssen mit StrPtr(MyString) übergeben werden.

Betriebssystem

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

  • Windows NT 3.1 oder später

Verweise