Método IAzScope::AddPropertyItem (azroles.h)

  • Artículo

El método AddPropertyItem agrega la entidad de seguridad especificada a la lista de entidades de seguridad especificadas.

Sintaxis

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

Parámetros

[in] lPropId

Id. de propiedad de la lista de entidades de seguridad a las que se va a agregar la entidad de seguridad especificada por el parámetro varProp . En la siguiente tabla se muestran los valores posibles.

Valor Significado
AZ_PROP_POLICY_ADMINS
 También se puede agregar mediante el método AddPolicyAdministrator .
AZ_PROP_POLICY_ADMINS_NAME
 También se puede agregar mediante el método AddPolicyAdministratorName .
AZ_PROP_POLICY_READERS
 También se puede agregar mediante el método AddPolicyReader
AZ_PROP_POLICY_READERS_NAME
 También se puede agregar mediante el método AddPolicyReaderName .

[in] varProp

Entidad de seguridad que se va a agregar a la lista de entidades de seguridad especificadas por el parámetro lPropId .

La variante debe ser una variante BSTR .

Si se especifica AZ_PROP_POLICY_ADMINS o AZ_PROP_POLICY_READERS para el parámetro lPropId , la cadena es el formato de texto del identificador de seguridad (SID) de la cuenta de Windows que se va a agregar a la lista. Si se especifica AZ_PROP_POLICY_ADMINS_NAME o AZ_PROP_POLICY_READERS_NAME para el parámetro lPropId , la cadena es el nombre de cuenta de la cuenta que se va a agregar a la lista. El nombre de la cuenta puede estar en formato de nombre principal de usuario (UPN) (por ejemplo, "someone@example.com") o en el formato "ExampleDomain\UserName".

[in, optional] varReserved

Reservado para uso futuro.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que se ha realizado correctamente. Cualquier otro valor indica que se produjo un error en la operación.

Comentarios

Debe llamar al método Submit para conservar los cambios realizados por este método.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado azroles.h
Library Azroles.lib
Archivo DLL Azroles.dll
Redistribuible Paquete de herramientas de administración de Windows Server 2003 en Windows XP