Fungsi CopySid (securitybaseapi.h)

Artikel
03/04/2024

Fungsi CopySid menyalin pengidentifikasi keamanan (SID) ke buffer.

Sintaks

BOOL CopySid(
  [in]  DWORD nDestinationSidLength,
  [out] PSID  pDestinationSid,
  [in]  PSID  pSourceSid
);

Parameter

[in] nDestinationSidLength

Menentukan panjang, dalam byte, dari buffer yang menerima salinan SID.

[out] pDestinationSid

Penunjuk ke buffer yang menerima salinan struktur SID sumber.

[in] pSourceSid

Penunjuk ke struktur SID yang disalin fungsi ke buffer yang diacu oleh parameter pDestinationSid .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Aplikasi dapat menggunakan fungsi CopySid untuk membuat salinan SID dalam token akses (misalnya, dalam struktur TOKEN_GROUPS ) untuk digunakan dalam entri kontrol akses (ACE).

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Mendapatkan SID Masuk.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll