GetUserNameEx: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K ("verwaltet von" auskommentiert)
Zeile 3: Zeile 3:
 
Mit GetUserNameEx können diverse Informationen zum angemeldeten Benutzer ermittelt werden.
 
Mit GetUserNameEx können diverse Informationen zum angemeldeten Benutzer ermittelt werden.
  
= Deklaration =
+
== Deklaration ==
<PRE>
+
<code vb>
 
Declare Function GetUserNameEx Lib "secur32.dll" _
 
Declare Function GetUserNameEx Lib "secur32.dll" _
 
                 Alias "GetUserNameExA" ( _
 
                 Alias "GetUserNameExA" ( _
Zeile 11: Zeile 11:
 
                 ByRef nSize As Long) As Long
 
                 ByRef nSize As Long) As Long
  
</PRE>
+
</code>
  
  
Zeile 29: Zeile 29:
  
 
== Rückgabe ==
 
== Rückgabe ==
War der Aufruf erfolgreich, ist der Wert ungleich 0. Anderenfalls kann der Fehlercode mit [[GetLastError]] ermittelt werden.<BR>
+
War der Aufruf erfolgreich, ist der Wert ungleich 0. Anderenfalls kann der Fehlercode mit [[Err.LastDLLError]] ermittelt werden.<BR>
 
Ist die Zeichenkette nicht ausreichend groß, wird die benötigte Größe in ''nSize'' übertragen.
 
Ist die Zeichenkette nicht ausreichend groß, wird die benötigte Größe in ''nSize'' übertragen.
  
  
= Beispiel =
+
== Beispiel ==
<PRE>
+
<code vb>
 
Dim strBuffer As String
 
Dim strBuffer As String
 
Dim lngBufSize As Long
 
Dim lngBufSize As Long
Zeile 61: Zeile 61:
  
 
Debug.Print strBuffer
 
Debug.Print strBuffer
</PRE>
+
</code>
  
  
  
= Betriebssysteme =
+
== Betriebssysteme ==
  
*Windows NT 5.0 (2000) und neuer
+
*ab Windows NT 5.0 (2000)
*Windows CE .NET 4.0 (und neuer)
+
*ab Windows CE .NET 4.0
  
  
= Verwandte Funktionen =
+
== Verwandte Funktionen ==
 
[[GetUserName]]
 
[[GetUserName]]
  
  
  
= Quellen =
+
== Quellen ==
 
[http://msdn2.microsoft.com/en-us/library/ms902915.aspx MSDN Library: GetUserNameEx]
 
[http://msdn2.microsoft.com/en-us/library/ms902915.aspx MSDN Library: GetUserNameEx]
  
  
 
----
 
 
<!--{{Benutzer:Bernhard Döbler/Vorlage:Zuständig|Helge Rex}}-->
 
  
 
[[Kategorie:Secur32]]
 
[[Kategorie:Secur32]]

Version vom 13. Mai 2008, 10:20 Uhr


Mit GetUserNameEx können diverse Informationen zum angemeldeten Benutzer ermittelt werden.

Deklaration

Declare Function GetUserNameEx Lib "secur32.dll" _

               Alias "GetUserNameExA" ( _
               ByVal NameFormat As EXTENDED_NAME_FORMAT, _
               ByVal lpBuffer As String, _
               ByRef nSize As Long) As Long


Paramter

NameFormat

Element aus EXTENDED_NAME_FORMAT, mit dem festgelegt wird, welche Informationen ermittelt werden sollen.


lpBuffer

Zeichenkette, die die ermittelten Informationen aufnimmt.


nSize

Länge der Zeichenkette, die die ermittelten Informationen aufnimmt.


Rückgabe

War der Aufruf erfolgreich, ist der Wert ungleich 0. Anderenfalls kann der Fehlercode mit Err.LastDLLError ermittelt werden.
Ist die Zeichenkette nicht ausreichend groß, wird die benötigte Größe in nSize übertragen.


Beispiel

Dim strBuffer As String Dim lngBufSize As Long Dim lngResult As Long

' Benötigten Speicher ermitteln lngResult = GetUserNameEx(enfNameSamCompatible, strBuffer, lngBufSize)

' Speicher bereitstellen strBuffer = String$(lngBufSize \ 2, &H0&)

' Informationen auslesen lngResult = GetUserNameEx(enfNameSamCompatible, strBuffer, lngBufSize)

' Informationen nachbearbeiten If (lngResult <> 0) Then

   '   Abschließendes NullByte entfernen
   lngBufSize = InStr(1, strBuffer, vbNullChar)
   If lngBufSize <> 0 Then
       strBuffer = Left$(strBuffer, lngBufSize)
   End If

Else

   '   Da liegt wohl ein Fehler vor
   strBuffer = vbNullString

End If

Debug.Print strBuffer


Betriebssysteme

  • ab Windows NT 5.0 (2000)
  • ab Windows CE .NET 4.0


Verwandte Funktionen

GetUserName


Quellen

MSDN Library: GetUserNameEx