RasGetAutodialAddressA-Funktion (ras.h)
Die RasGetAutodialAddress-Funktion ruft Informationen zu allen AutoDialeinträgen ab, die einer Netzwerkadresse in der AutoDial-Zuordnungsdatenbank zugeordnet sind.
Syntax
DWORD RasGetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] LPDWORD unnamedParam2,
[in, out] LPRASAUTODIALENTRYA unnamedParam3,
[in, out] LPDWORD unnamedParam4,
[out] LPDWORD unnamedParam5
);
Parameter
[in] unnamedParam1
Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die die Adresse angibt, für die Informationen angefordert werden. Dabei kann es sich um eine IP-Adresse, einen Internethostnamen ("www.microsoft.com") oder einen NetBIOS-Namen ("Products1") handeln.
Wenn dieser Parameter NULL-ist, ruft die Funktion die Standard-Internetverbindung ab. Die Funktion gibt die standardmäßige Internetverbindung pro Benutzer zurück, wenn eine konfiguriert ist. Andernfalls gibt die Funktion die globale Standard-Internetverbindung zurück. Wenn keine Standard-Internetverbindungen konfiguriert sind, gibt die Funktion null für die parameter lpdwcbAutoDialEntries und lpdwcAutoDialEntries Parameter zurück.
[in] unnamedParam2
Reserviert; muss NULL-sein.
[in, out] unnamedParam3
Zeiger auf einen Puffer, der bei der Ausgabe ein Array von RASAUTODIALENTRY- Strukturen empfängt, eines für jeden autoDial-Eintrag, der der adresse zugeordnet ist, die durch den lpszAddress Parameter angegeben ist.
Legen Sie bei eingaben das dwSize Member des ersten RASAUTODIALENTRY Struktur im Puffer auf "sizeof(RASAUTODIALENTRY)" fest, um die Version der Struktur zu identifizieren.
Wenn
[in, out] unnamedParam4
Zeiger auf eine Variable, die bei Eingabe die Größe des lpAutoDialEntries- Puffers in Byte angibt.
Bei der Ausgabe empfängt diese Variable die Anzahl der zurückgegebenen Bytes oder die Anzahl der erforderlichen Bytes, wenn der Puffer zu klein ist.
[out] unnamedParam5
Zeiger auf eine Variable, die die Anzahl der im lpAutoDialEntries Puffer zurückgegebenen Strukturelemente empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und Remotezugriffsfehlercodes oder Winerror.h.
| Wert | Bedeutung |
|---|---|
|
Der dwSize Member der RASAUTODIALENTRY Struktur ist ein ungültiger Wert. |
|
Der lpszAddress, lpdwcbAutoDialEntriesoder lpdwcAutoDialEntries Parameter war NULL. |
Bemerkungen
Der Remotezugriffsdienst (RAS) unterstützt Standardmäßige Internetverbindungen. RAS unterstützt eine standardmäßige Internetverbindung, die global auf dem lokalen Computer ist, und unterstützt darüber hinaus eine Standard-Internetverbindung für jeden Benutzer.
Der Name der globalen Standard-Internetverbindung wird in der Registrierung unter dem folgenden Registrierungsschlüssel gespeichert:
HKEY_LOCAL_MACHINE Software Microsoft Ras Autodial Default
Der Wert, der den Namen der Verbindung speichert, lautet:
DefaultInternet-
Dieser Wert ist vom Typ REG_SZ.
Die globale Standard-Internetverbindung muss als Für alle Benutzer Verbindung in der Connections Folder Benutzeroberfläche konfiguriert werden.
Der Name der standardmäßigen Internetverbindung pro Benutzer wird in der Registrierung unter dem folgenden Registrierungsschlüssel gespeichert:
HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\Standard-
Der Wert, der den Namen der Verbindung speichert, lautet:
DefaultInternet-
Dieser Wert ist vom Typ REG_SZ.
Anmerkung
Der ras.h-Header definiert RasGetAutodialAddress als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | ras.h |
| Library | Rasapi32.lib |
| DLL- | Rasapi32.dll |
Siehe auch
übersicht über Ras(Remote Access Service)