RasSetCredentialsA-Funktion (ras.h)
Die RasSetCredentials--Funktion legt die Benutzeranmeldeinformationen fest, die einem angegebenen RAS-Telefonbucheintrag zugeordnet sind.
Syntax
DWORD RasSetCredentialsA(
[in] LPCSTR unnamedParam1,
[in] LPCSTR unnamedParam2,
[in] LPRASCREDENTIALSA unnamedParam3,
[in] BOOL unnamedParam4
);
Parameter
[in] unnamedParam1
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL-ist, verwendet die Funktion die aktuelle Standarddatei des Telefonbuchs. Die Standardmäßige Telefonbuchdatei ist die vom Benutzer im Eigenschaftenblatt Benutzereinstellungen Eigenschaftenblatt des Dialogfelds DFÜ-Netzwerk ausgewählt.
[in] unnamedParam2
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen eines Telefonbucheintrags angibt.
[in] unnamedParam3
Ein Zeiger auf eine RASCREDENTIALS- Struktur, die die Für den angegebenen Telefonbucheintrag festzulegenden Benutzeranmeldeinformationen angibt. Legen Sie vor dem Aufrufen RasSetCredentials-das dwSize Element der Struktur auf sizeof(RASCREDENTIALS) fest, und legen Sie das dwMask-element fest, um die festzulegenden Anmeldeinformationsinformationen anzugeben.
[in] unnamedParam4
Ein Wert, der angibt, ob RasSetCredentials vorhandene Anmeldeinformationen löscht, indem sie auf die leere Zeichenfolge "" festlegen. Wenn dieses Kennzeichen TRUEist, gibt das dwMask Member der RASCREDENTIALS- Struktur an, welche Anmeldeinformationen die Funktion auf die leere Zeichenfolge festlegt. Wenn dieses Kennzeichen FALSEist, legt die Funktion die angegebenen Anmeldeinformationen entsprechend dem Inhalt ihrer entsprechenden RASCREDENTIALS Member fest.
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 |
|---|---|
|
Das angegebene Telefonbuch kann nicht gefunden werden. |
|
Der parameter lpCredentials war NULL-, oder der angegebene Eintrag ist im Telefonbuch nicht vorhanden. |
|
Eine der folgenden Bedingungen ist aufgetreten:
|
Bemerkungen
Die RasSetCredentials--Funktion legt die Benutzeranmeldeinformationen fest, die einem angegebenen RAS-Telefonbucheintrag zugeordnet sind. Die mit einem Telefonbucheintrag gespeicherten Anmeldeinformationen sind die Anmeldeinformationen des letzten Benutzers, die mithilfe des angegebenen Telefonbucheintrags erfolgreich verbunden werden sollen, oder die anmeldeinformationen, die anschließend in einem Anruf an die RasSetCredentials oder RasSetEntryDialParams Funktion für den Telefonbucheintrag angegeben wurden.
Die RasSetCredentials--Funktion ist die bevorzugte Methode zum sicheren Speichern von Anmeldeinformationen mit einem Telefonbucheintrag. RasSetCredentials ersetzt die RasSetEntryDialParams Funktion, die in zukünftigen Versionen des Windows-Betriebssystems möglicherweise nicht unterstützt wird.
Ein Kennworthandle ist "****************" (16 Sternchen). Wenn Sie RasGetCredentials- aufrufen und 16 *s zurück in das Kennwortfeld erhalten, haben Sie ein gespeichertes Kennwort und aus Sicherheitsgründen wird es Ihnen nicht in Nur-Text zurückgesendet. Wenn das szPassword Mitglied der RASCREDENTIALS- Struktur das Kennworthandle (16 *s) enthält, das von RasGetCredentials oder RasGetEntryDialParamszurückgegeben wird, ändert der nächste Aufruf von RasSetCredentials das gespeicherte Kennwort nicht.
Um die Standardanmeldeinformationen für eine verbindung mit allen Benutzern festzulegen, legen Sie das RASCM_DefaultCreds Flag im dwMask Member der RASCREDENTIALS- Struktur fest, auf die durch den parameter lpCredentials verwiesen wird. Wenn Sie versuchen, Standardanmeldeinformationen für eine Benutzerverbindung festzulegen, gibt RasSetCredentialsERROR_ACCESS_DENIEDzurück.
Wenn die aufrufende Anwendung beim Festlegen von Anmeldeinformationen für eine Verbindung mit allen Benutzern einen Wert ungleich NULL für den Phone-Book-Parameter angibt, lpszPhonebook, muss sich die Phone-Book-Datei im Telefonbuchverzeichnis unterhalb des Datenpfads für alle Benutzer befinden. Um den richtigen Speicherort für die Telefonbuchdatei abzurufen, rufen Sie zuerst SHGetFolderPath- mit einem CSIDL- Wert von CSIDL_COMMON_APPDATAauf. SHGetFolderPath- gibt den Datenpfad für alle Benutzer zurück. Fügen Sie die folgende Zeichenfolge an diesen Pfad an:
Microsoft\Network\Connections\Pbk
Der kombinierte Pfad ist der richtige Speicherort für die Telefonbuchdatei.
Anmerkung
Der Ras.h-Header definiert RasSetCredentials 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)