EapHostPeerCredentialsXml2Blob-Funktion (eaphostpeerconfigapis.h)
Generiert das Anmeldeinformations-BLOB. Das Blob für Anmeldeinformationen enthält nur Benutzerdaten wie Benutzername, Kennwort und PIN. Ein Konfigurationsblob hingegen enthält die Einstellungen, die das Verhalten der -Methode steuern.
Syntax
DWORD EapHostPeerCredentialsXml2Blob(
[in] DWORD dwFlags,
[in] IXMLDOMNode *pCredentialsDoc,
[in] DWORD dwSizeOfConfigIn,
[in] BYTE *pConfigIn,
[out] DWORD *pdwSizeOfCredentialsOut,
[out] BYTE **ppCredentialsOut,
[out] EAP_METHOD_TYPE *pEapMethodType,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] dwFlags
Wird nicht verwendet. Auf 0 festlegen.
[in] pCredentialsDoc
Ein Zeiger auf einen XML-Knoten eines Dokuments, der Anmeldeinformationen enthält, bei denen es sich je nach übergebener Konfiguration um Benutzer- oder Computeranmeldeinformationen handelt. Das XML-Dokument wird mit dem EapHostUserCredentials-Schema erstellt.
[in] dwSizeOfConfigIn
Die Größe des Puffers in Bytes, auf den der pConfigIn-Parameter verweist.
[in] pConfigIn
Ein Zeiger auf einen Bytepuffer, der ein Konfigurationsblob enthält, für das die Anmeldeinformationen konfiguriert sind. Der Puffer hat die Größe dwSizeofConfigIn.
[out] pdwSizeOfCredentialsOut
Die Größe des Puffers in Bytes, auf den ppCredentialsOut verweist.
[out] ppCredentialsOut
Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der den vom Eingabe-XML generierten BLOB-Puffer für Anmeldeinformationen empfängt. Der Puffer kann die Größe pdwSizeofCredentialsOut aufweisen. Nach der Nutzung der Daten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden.
[out] pEapMethodType
Ein Zeiger auf eine EAP_METHOD_TYPE Struktur, auf die im XML-Dokument verwiesen wird.
[out] ppEapError
Ein Zeiger auf einen Zeiger auf eine EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.
Rückgabewert
Keine
Bemerkungen
Das Konfigurationsblob wird ursprünglich von einer der folgenden Methoden zurückgegeben.
Die XML-basierten Anmeldeinformationen können aus der Gruppenrichtlinie oder von einem Systemadministrator stammen.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eaphostpeerconfigapis.h |
| Bibliothek | Eappcfg.lib |
| DLL | Eappcfg.dll |