Fungsi SspiEncodeAuthIdentityAsStrings (sspi.h)

  • Artikel

Mengodekan identitas autentikasi yang ditentukan sebagai tiga string.

Sintaks

SECURITY_STATUS SEC_ENTRY SspiEncodeAuthIdentityAsStrings(
  [in]  PSEC_WINNT_AUTH_IDENTITY_OPAQUE pAuthIdentity,
  [out] PCWSTR                          *ppszUserName,
  [out] PCWSTR                          *ppszDomainName,
  [out] PCWSTR                          *ppszPackedCredentialsString
);

Parameter

[in] pAuthIdentity

Struktur kredensial yang akan dikodekan.

[out] ppszUserName

Nama pengguna marshaled identitas yang ditentukan oleh parameter pAuthIdentity .

Setelah Anda selesai menggunakan string ini, bebaskan dengan memanggil fungsi SspiFreeAuthIdentity .

[out] ppszDomainName

Nama domain marsekal identitas yang ditentukan oleh parameter pAuthIdentity .

Setelah Anda selesai menggunakan string ini, bebaskan dengan memanggil fungsi SspiFreeAuthIdentity .

[out] ppszPackedCredentialsString

Versi string yang dikodekan dari struktur SEC_WINNT_AUTH_IDENTITY_EX2 yang menentukan kredensial pengguna.

Setelah Anda selesai menggunakan string ini, bebaskan dengan memanggil fungsi SspiFreeAuthIdentity .

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai Deskripsi
STATUS_INVALID_PARAMETER
0xC000000D
 Bendera SEC_WINNT_AUTH_IDENTITY_FLAGS_PROCESS_ENCRYPTED diatur dalam struktur identitas yang ditentukan oleh parameter pAuthIdentity .

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header sspi.h
Pustaka Secur32.lib
DLL SspiCli.dll