RasSetAutodialAddressA-Funktion (ras.h)
Die RasSetAutodialAddress-Funktion kann der AutoDial-Zuordnungsdatenbank eine Adresse hinzufügen. Alternativ kann die Funktion die Daten löschen oder ändern, die einer vorhandenen Adresse in der Datenbank zugeordnet sind.
Syntax
DWORD RasSetAutodialAddressA(
[in] LPCSTR unnamedParam1,
[in] DWORD unnamedParam2,
[in] LPRASAUTODIALENTRYA unnamedParam3,
[in] DWORD unnamedParam4,
[in] DWORD unnamedParam5
);
Parameter
[in] unnamedParam1
Zeiger auf eine NULL--terminated-Zeichenfolge, die die Adresse angibt, die hinzugefügt, gelöscht oder geändert werden soll. Diese Adresse kann eine IP-Adresse, internethostname ("www.microsoft.com") oder NetBIOS name ("products1") sein.
Wenn dieser Parameter NULL-ist, legt die Funktion die Standard-Internetverbindung fest (siehe Hinweise). Wenn dieser Parameter auf eine leere Zeichenfolge zeigt, löscht die Funktion die Standard-Internetverbindung.
[in] unnamedParam2
Reserviert; muss null sein.
[in] unnamedParam3
Zeiger auf ein Array von einem oder mehreren RASAUTODIALENTRY- Strukturen, die der lpszAddress- Adresse zugeordnet werden sollen. Wenn lpAutoDialEntries null ist und dwcbAutoDialEntries null ist, löscht RasSetAutodialAddress alle Strukturen, die lpszAddress zugeordnet sind, aus der Zuordnungsdatenbank.
[in] unnamedParam4
Gibt die Größe des lpAutoDialEntries- Puffers in Bytes an.
[in] unnamedParam5
Gibt die Anzahl der RASAUTODIALENTRY- Strukturen im lpAutoDialEntries Puffer an.
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 parameter lpszAddress ist NULL. |
|
Der in lpAutoDialEntries angegebene Verbindungsname ist nicht vorhanden. |
Bemerkungen
Eine Adresse in der AutoDial-Zuordnungsdatenbank kann eine beliebige Anzahl von zugeordneten RASAUTODIALENTRY Einträgen aufweisen. Jeder Eintrag gibt AutoDialinformationen für einen bestimmten TAPI-Wählspeicherort an.
Wenn die durch den parameter lpszAddress angegebene Adresse eine vorhandene Adresse in der Datenbank ist und der parameter lpAutoDialEntries Parameter nicht NULList, ändert die RasSetAutodialAddress-Funktion den Satz der autoDial-Einträge, die der Adresse zugeordnet sind. Wenn ein Eintrag in der lpAutoDialEntries Array einen Wählspeicherort angibt, für den die Adresse bereits einen Eintrag aufweist, ersetzt die Funktion den vorhandenen Eintrag durch den neuen Eintrag. Andernfalls fügt die Funktion einfach die lpAutoDialEntries Einträge zu den Einträgen für die Adresse hinzu.
Wenn die lpszAddress Adresse in der Datenbank vorhanden ist, ist lpAutoDialEntries-NULL-, und lpAutoDialEntries null ist, RasSetAutodialAddress die Adresse aus der Datenbank löscht.
Wenn die lpszAddress Adresse nicht in der Datenbank vorhanden ist, RasSetAutodialAddress die Adresse der Datenbank hinzufügt. Der lpAutoDialEntries Parameter gibt die AutoDial-Einträge an, die der neuen Adresse zugeordnet werden sollen.
RAS unterstützt eine standardinterne Internetverbindung, die global auf dem lokalen Computer ist und eine Standard-Internetverbindung für jeden Benutzer unterstützt.
Wenn der parameter lpszAddressNULList und der parameter lpAutoDialEntries parameter einen Verbindungsnamen mit einem Eintrag angibt, legt RasSetAutodialAddress die Verbindung als Standard-Internetverbindung fest. Der in lpAutoDialEntries angegebene Verbindungsname sollte bereits vorhanden sein. Wenn dies nicht der Fall ist, wird ERROR_CANNOT_FIND_PHONEBOOK_ENTRY zurückgegeben.
Wenn der parameter lpszAddress eine leere Zeichenfolge ist und der parameter lpAutoDialEntries parameter einen leeren Verbindungsnamen mit einem Eintrag angibt, RasSetAutodialAddress die Standard-Internetverbindung löscht.
Wenn ein Benutzer auf nicht domänenfremden Clientcomputern eine Verbindung als Standard-Internetverbindung festlegen möchte und im szEntry Mitglied der RASAUTODIALENTRY- Struktur eine Verbindung für alle Benutzer angibt, wird die Standard-Internetverbindung global auf dem lokalen Computer festgelegt. In allen anderen Fällen wird die Standard-Internetverbindung für jeden Benutzer des Computers einzeln festgelegt.
Es ist möglich, zwei Verbindungen mit demselben Namen zu haben, wenn eine als "für alle Benutzer"-Verbindung konfiguriert ist und die andere als "nur für mich"-Verbindung konfiguriert ist. Wenn der lpAutoDialEntries Parameter einen Verbindungsnamen angibt, der sowohl einer globalen als auch einer Benutzerverbindung entspricht, wird die Pro-Benutzer-Verbindung festgelegt.
Anmerkung
Der ras.h-Header definiert RasSetAutodialAddress als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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)