RasSetAutodialAddressW-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 RasSetAutodialAddressW(
  [in] LPCWSTR             unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYW unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

Parameter

[in] unnamedParam1

Zeiger auf eine NULL-endende Zeichenfolge, die die Adresse angibt, die hinzugefügt, gelöscht oder geändert werden soll. Bei dieser Adresse kann es sich um eine IP-Adresse, einen Internethostnamen ("www.microsoft.com") oder einen NetBIOS-Namen ("products1") handeln.

Wenn dieser Parameter NULL ist, legt die Funktion die Standard-Internetverbindung fest (siehe Hinweise). Wenn dieser Parameter auf eine Zeichenfolge der Länge Null verweist, löscht die Funktion die Standard-Internetverbindung.

[in] unnamedParam2

Reserviert; muss null sein.

[in] unnamedParam3

Zeiger auf ein Array einer oder mehrerer RASAUTODIALENTRY-Strukturen , die der lpszAddress-Adresse zugeordnet werden sollen. Wenn lpAutoDialEntriesNULL 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 puffer lpAutoDialEntries 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 RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
ERROR_INVALID_SIZE	Der dwSize-Member der RASAUTODIALENTRY-Struktur ist ein ungültiger Wert.
ERROR_INVALID_PARAMETER	Der lpszAddress-Parameter ist NULL.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Der in lpAutoDialEntries angegebene Verbindungsname ist nicht vorhanden.

Hinweise

Eine Adresse in der AutoDial-Zuordnungsdatenbank kann eine beliebige Anzahl zugeordneter RASAUTODIALENTRY-Einträge aufweisen. Jeder Eintrag gibt AutoDial-Informationen für einen bestimmten TAPI-Wählort an.

Wenn die vom lpszAddress-Parameter angegebene Adresse eine vorhandene Adresse in der Datenbank ist und der lpAutoDialEntries-Parameter nicht NULL ist, ändert die RasSetAutodialAddress-Funktion den Satz von AutoDial-Einträgen, die der Adresse zugeordnet sind. Wenn ein Eintrag im lpAutoDialEntries-Array einen Wählort angibt, für den die Adresse bereits einen Eintrag enthält, ersetzt die Funktion den vorhandenen Eintrag durch den neuen Eintrag. Andernfalls fügt die Funktion einfach die lpAutoDialEntries-Einträge dem Satz von Einträgen für die Adresse hinzu.

Wenn die lpszAddress-Adresse in der Datenbank vorhanden ist, lpAutoDialEntriesnull und lpAutoDialEntries null ist, löscht RasSetAutodialAddress die Adresse aus der Datenbank.

Wenn die lpszAddress-Adresse nicht in der Datenbank vorhanden ist, fügt RasSetAutodialAddress die Adresse der Datenbank hinzu. Der parameter lpAutoDialEntries gibt die AutoDial-Einträge an, die der neuen Adresse zugeordnet werden sollen.

RAS unterstützt eine Standard-Internetverbindung, die global für den lokalen Computer ist, und eine Standard-Internetverbindung für jeden Benutzer.

Wenn der parameter lpszAddressNULL ist und der 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. Andernfalls wird ERROR_CANNOT_FIND_PHONEBOOK_ENTRY zurückgegeben.

Wenn der lpszAddress-Parameter eine Zeichenfolge der Länge null ist und der parameter lpAutoDialEntries einen leeren Verbindungsnamen mit einem Eintrag angibt, löscht RasSetAutodialAddress die Standard-Internetverbindung.

Wenn ein Benutzer auf Clientcomputern ohne Domäne eine Verbindung als Standard-Internetverbindung festlegen möchte und eine "for-all-users"-Verbindung im szEntry-Member der RASAUTODIALENTRY-Struktur 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 "for-all-users"-Verbindung und die andere als "for-me-only"-Verbindung konfiguriert ist. Wenn der lpAutoDialEntries-Parameter einen Verbindungsnamen angibt, der sowohl einer globalen als auch einer Benutzerverbindung entspricht, wird die Verbindung pro Benutzer festgelegt.

Hinweis

Der ras.h-Header definiert RasSetAutodialAddress 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasGetAutodialAddress

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts