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

  • Artigo

O método AddPropertyItem adiciona a entidade de segurança especificada à lista especificada de entidades de segurança.

Sintaxe

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

Parâmetros

[in] lPropId

ID da propriedade da lista de entidades de segurança à qual adicionar a entidade de segurança especificada pelo parâmetro varProp . A tabela a seguir mostra os valores possíveis.

Valor Significado
AZ_PROP_POLICY_ADMINS
 Também pode ser adicionado usando o método AddPolicyAdministrator
AZ_PROP_POLICY_ADMINS_NAME
 Também pode ser adicionado usando o método AddPolicyAdministratorName
AZ_PROP_POLICY_READERS
 Também pode ser adicionado usando o método AddPolicyReader
AZ_PROP_POLICY_READERS_NAME
 Também pode ser adicionado usando o método AddPolicyReaderName

[in] varProp

Entidade de segurança a ser adicionada à lista de entidades especificadas pelo parâmetro lPropId .

A variante deve ser uma variante BSTR .

Se AZ_PROP_POLICY_ADMINS ou AZ_PROP_POLICY_READERS for especificado para o parâmetro lPropId , a cadeia de caracteres será a forma de texto do SID ( identificador de segurança ) da conta do Windows a ser adicionada à lista. Se AZ_PROP_POLICY_ADMINS_NAME ou AZ_PROP_POLICY_READERS_NAME for especificado para o parâmetro lPropId , a cadeia de caracteres será o nome da conta a ser adicionada à lista. O nome da conta pode estar no formato UPN (nome upn) (por exemplo, "someone@example.com") ou no formato "ExampleDomain\UserName".

[in, optional] varReserved

Reservado para uso futuro.

Retornar valor

O valor retornado é um HRESULT. Um valor de S_OK indica êxito. Qualquer outro valor indica que a operação falhou.

Comentários

Você deve chamar o método Submit para persistir as alterações feitas por esse método.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho azroles.h
Biblioteca Azroles.lib
DLL Azroles.dll
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP