Bagikan melalui

Fungsi CredGetTargetInfoA (wincred.h)

Fungsi CredGetTargetInfo mengambil semua informasi nama target yang diketahui untuk komputer target bernama. Ini dijalankan secara lokal dan tidak memerlukan hak istimewa tertentu. Informasi yang dikembalikan diharapkan diteruskan ke CredReadDomainCredentials dan credWriteDomainCredentials fungsi. Informasi tidak boleh digunakan untuk tujuan lain.

Paket autentikasi menghitung TargetInfo saat mencoba mengautentikasi ke TargetName. Paket autentikasi menyimpan informasi target ini untuk membuatnya tersedia untuk CredGetTargetInfo. Oleh karena itu, informasi target hanya akan tersedia dari upaya baru-baru ini untuk mengautentikasi TargetName.

Paket autentikasi yang tidak dalam proses LSA dapat menyimpan TargetInfo untuk pengambilan nanti dengan CredGetTargetInfo dengan memanggil CredReadDomainCredentials dengan bendera CRED_CACHE_TARGET_INFORMATION.

Sintaksis

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

Parameter

[in] TargetName

Penunjuk ke string null-terminated yang berisi nama komputer target yang informasinya akan diambil.

[in] Flags

Bendera yang mengontrol operasi fungsi. Bendera berikut dapat digunakan:

CRED_ALLOW_NAME_RESOLUTION

Jika tidak ada informasi target yang dapat ditemukan untuk resolusi nama TargetName dilakukan pada TargetName untuk mengonversinya ke formulir lain. Jika ada informasi target untuk salah satu formulir lain, informasi tersebut akan dikembalikan. Saat ini hanya resolusi nama DNS yang dilakukan.

Ini berguna jika aplikasi tidak memanggil paket autentikasi secara langsung. Aplikasi dapat meneruskan TargetName ke lapisan perangkat lunak lain untuk mengautentikasi ke server, dan lapisan perangkat lunak tersebut dapat menyelesaikan nama dan meneruskan nama yang diselesaikan ke paket autentikasi. Dengan demikian, tidak akan ada informasi target untuk TargetName asli.

[out] TargetInfo

Penunjuk ke satu buffer blok yang dialokasikan untuk berisi informasi target. Setidaknya salah satu anggota TargetInfo yang dikembalikan akan non-NULL. Setiap pointer yang terkandung dalam buffer adalah pointer ke lokasi dalam blok yang dialokasikan tunggal ini. Buffer tunggal yang dikembalikan harus dibebaskan dengan memanggil CredFree.

Mengembalikan nilai

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

  • ERROR_NOT_FOUND

    Informasi target untuk server bernama tidak tersedia.

Komentar

Nota

Header wincred.h mendefinisikan CredGetTargetInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

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

Lihat juga

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

GetLastError