Metode IAzScope::AddPropertyItem (azroles.h)

Metode AddPropertyItem menambahkan prinsipal yang ditentukan ke daftar prinsipal yang ditentukan.

Sintaks

HRESULT AddPropertyItem(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

Parameter

[in] lPropId

ID properti dari daftar prinsipal yang akan ditambahkan prinsipal yang ditentukan oleh parameter varProp . Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai Makna
AZ_PROP_POLICY_ADMINS
Juga dapat ditambahkan menggunakan metode AddPolicyAdministrator
AZ_PROP_POLICY_ADMINS_NAME
Juga dapat ditambahkan menggunakan metode AddPolicyAdministratorName
AZ_PROP_POLICY_READERS
Juga dapat ditambahkan menggunakan metode AddPolicyReader
AZ_PROP_POLICY_READERS_NAME
Juga dapat ditambahkan menggunakan metode AddPolicyReaderName

[in] varProp

Prinsipal untuk ditambahkan ke daftar prinsipal yang ditentukan oleh parameter lPropId .

Varian harus merupakan varian BSTR .

Jika AZ_PROP_POLICY_ADMINS atau AZ_PROP_POLICY_READERS ditentukan untuk parameter lPropId , string adalah bentuk teks pengidentifikasi keamanan (SID) akun Windows untuk ditambahkan ke daftar. Jika AZ_PROP_POLICY_ADMINS_NAME atau AZ_PROP_POLICY_READERS_NAME ditentukan untuk parameter lPropId , string adalah nama akun akun yang akan ditambahkan ke daftar. Nama akun dapat dalam format nama prinsipal pengguna (UPN) (misalnya, "someone@example.com") atau dalam format "ExampleDomain\UserName".

[in, optional] varReserved

Disiapkan untuk penggunaan masa mendatang.

Mengembalikan nilai

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan. Nilai lain menunjukkan bahwa operasi gagal.

Keterangan

Anda harus memanggil metode Kirim untuk mempertahankan perubahan apa pun yang dibuat oleh metode ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header azroles.h
Pustaka Azroles.lib
DLL Azroles.dll
Redistribusi Paket Alat Administrasi Windows Server 2003 pada Windows XP