Die Community zu .NET und Classic VB.
Menü

GetPrivateProfileString

 von 

Deklaration  

Declare Function GetPrivateProfileString Lib "kernel32" _
                 Alias "GetPrivateProfileStringA" ( _
                 ByVal lpApplicationName As String, _
                 ByVal lpKeyName As Any, _
                 ByVal lpDefault As String, _
                 ByVal lpReturnedString As String, _
                 ByVal nSize As Long, _
                 ByVal lpFileName As String) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetPrivateProfileString des API-Wikis.

GetPrivateProfileString

Parameter
lpApplicationNameEin Zeiger auf einen nullterminierten String, der den Abschnittsnamen enthält. Wenn dieser Parameter gleich Null ist, werden alle Abschnittsnamen der INI-Datei statt dessen in den Puffer kopiert.
lpKeyNameEin Zeiger auf einen nullterminierten String, der den Schlüsselnamen enthält. Wenn dieser Parameter gleich Null ist, werden alle Abschnittsnamen der INI-Datei statt dessen in den Puffer kopiert.
lpDefaultEin Zeiger auf einen nullterminierten String, der den Standardwert enthält, der zurückgegeben wird, wenn der Schlüssel im angegebenen Abschnitt nicht gefunden wurde.
lpReturnedStringZeiger auf den Puffer, der vom System gefüllt wird, bei der Rückgabe eines Wertes für einen Schlüssel enthält dieser Puffer normalerweise einen einzigen nullterminierten String. Wenn Abschnitts- oder Schlüsselnamen einer INI-Datei ermittelt werden (durch Angabe von Null für lpApplicationName bzw. lpKeyName), wird der Puffer mit einer Liste nullterminierter Strings gefüllt, wobei der letzte String mit zwei Terminierungszeichen abgeschlossen wird.
nSizeGröße des Puffers lpReturnedString, der die Daten entgegennimmt.
lpFileNameEin Zeiger auf einen nullterminierten String, der den Namen der INI-Datei enthält. Wenn dieser Parameter keinen vollständigen Pfadnamen enthält, such Windows im Windows-Verzeichnis nach ihr.

Tabelle 1


Rückgabewerte
LongDie Anzahl der Zeichen die in den Puffer kopiert wurden, wobei das Terminierungszeichen nicht berücksichtigt wird. Wenn nicht genügend Speicherplatz zur Verfügung gestellt wurde, ist der Rückgabewert -1

Tabelle 2


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetProfileString, WritePrivateProfileString

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel