Fungsi CopySid (securitybaseapi.h)
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 |