CredMarshalCredentialA-Funktion (wincred.h)

Artikel
11/20/2024

Die CredMarshalCredential--Funktion wandelt eine Anmeldeinformation in eine Textzeichenfolge um. In der Vergangenheit nehmen viele Funktionen wie NetUseAddeinen Domänennamen, einen Benutzernamen und ein Kennwort als Anmeldeinformationen ein. Diese Funktionen akzeptieren keine Zertifikate als Anmeldeinformationen. Die CredMarshalCredential--Funktion wandelt solche Anmeldeinformationen in ein Formular um, das an diese APIs übergeben werden kann.

Die gemarsteten Anmeldeinformationen sollten als Benutzernamenzeichenfolge an eine beliebige API übergeben werden, die derzeit an Anmeldeinformationen übergeben wird. Der An diese API übergebene Domänenname sollte ggf. als NULL- oder leer übergeben werden. Bei Zertifikatanmeldeinformationen sollte die PIN des Zertifikats als Kennwort an diese API übergeben werden.

Der Aufrufer sollte keine marshalierten Anmeldeinformationen ändern oder drucken. Der zurückgegebene Wert kann frei zwischen unicode-, ANSI- und OEM-Zeichensätzen konvertiert werden. Bei der Zeichenfolge wird die Groß-/Kleinschreibung beachtet.

Syntax

BOOL CredMarshalCredentialA(
  [in]  CRED_MARSHAL_TYPE CredType,
  [in]  PVOID             Credential,
  [out] LPSTR             *MarshaledCredential
);

Parameter

[in] CredType

Typ der Anmeldeinformationen zum Marshallen.

[in] Credential

Anmeldeinformationen zum Marshallen.

Dies ist einer der CRED_MARSHAL_TYPE Werte.

Wenn CredType-CertCredential-ist, verweist Anmeldeinformation auf eine CERT_CREDENTIAL_INFO Struktur.

Wenn CredType-UsernameTargetCredential-ist, verweist Anmeldeinformation auf eine USERNAME_TARGET_CREDENTIAL_INFO Struktur.

[out] MarshaledCredential

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die die gemarsteten Anmeldeinformationen enthält. Der Aufrufer sollte den zurückgegebenen Puffer mit CredFreefreigeben.

Rückgabewert

Diese Funktion gibt TRUE bei Erfolg zurück und FALSE- bei Fehlern. Die GetLastError--Funktion kann aufgerufen werden, um einen spezifischeren Statuscode abzurufen. Der folgende Statuscode kann zurückgegeben werden:

ERROR_INVALID_PARAMETER

CredType- ist ungültig.

Bemerkungen

Anmerkung

Der wincred.h-Header definiert CredMarshalCredential 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 XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincred.h
Library	Advapi32.lib
DLL-	Advapi32.dll