Fungsi CredGetTargetInfoA (wincred.h)

  • Artikel

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 fungsi CredReadDomainCredentials dan CredWriteDomainCredentials . 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 terbaru untuk mengautentikasi TargetName.

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

Sintaks

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

Parameter

[in] TargetName

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

[in] Flags

Bendera yang mengontrol pengoperasian fungsi. Bendera berikut dapat digunakan:

CRED_ALLOW_NAME_RESOLUTION

Jika tidak ada informasi target yang dapat ditemukan untuk resolusi nama TargetName yang dilakukan pada TargetName untuk mengonversinya ke formulir lain. Jika informasi target ada untuk salah satu formulir lainnya, 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

Pointer 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 penunjuk ke lokasi dalam blok yang dialokasikan tunggal ini. Buffer tunggal yang dikembalikan harus dikosongkan dengan memanggil CredFree.

Nilai kembali

Fungsi 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_NOT_FOUND

    Informasi target untuk server bernama tidak tersedia.

Keterangan

Catatan

Header wincred.h mendefinisikan CredGetTargetInfo 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

Lihat juga

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

GetLastError