Fungsi CredUnmarshalCredentialA (wincred.h)

Artikel
03/03/2024

Fungsi CredUnmarshalCredential mengubah kredensial marshaled kembali ke bentuk aslinya.

Sintaks

BOOL CredUnmarshalCredentialA(
  [in]  LPCSTR             MarshaledCredential,
  [out] PCRED_MARSHAL_TYPE CredType,
  [out] PVOID              *Credential
);

Parameter

[in] MarshaledCredential

Penunjuk ke string null-terminated yang berisi kredensial marshaled.

[out] CredType

Jenis kredensial yang ditentukan oleh MarshaledCredential.

Ini adalah salah satu nilai CRED_MARSHAL_TYPE .

[out] Credential

Arahkan ke kredensial yang belum disembunyikan. Jika CredType mengembalikan CertCredential, penunjuk yang dikembalikan adalah ke struktur CERT_CREDENTIAL_INFO . Jika CredType mengembalikan UsernameTargetCredential, penunjuk yang dikembalikan adalah ke struktur USERNAME_TARGET_CREDENTIAL_INFO .

Pemanggil harus membebaskan buffer yang dikembalikan menggunakan CredFree.

Nilai kembali

Fungsi ini mengembalikan TRUE pada keberhasilan dan FALSE pada kegagalan. Fungsi GetLastError dapat dipanggil untuk mendapatkan kode status yang lebih spesifik. Kode status berikut dapat dikembalikan:

ERROR_INVALID_PARAMETER

MarshaledCredential tidak valid.

Keterangan

Catatan

Header wincred.h mendefinisikan CredUnmarshalCredential sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincred.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll