Função ADsPropCheckIfWritable (adsprop.h)

A função ADsPropCheckIfWritable determina se um atributo pode ser gravado.

Sintaxe

BOOL ADsPropCheckIfWritable(
  [in] const PWSTR          pwzAttr,
  [in] const PADS_ATTR_INFO pWritableAttrs
);

Parâmetros

[in] pwzAttr

Ponteiro para um buffer WCHAR terminado em NULL que contém o nome do atributo.

[in] pWritableAttrs

Ponteiro para a matriz de estruturas ADS_ATTR_INFOretornadas por ADsPropGetInitInfo.

Retornar valor

Retornará diferente de zero se o atributo for encontrado na lista de atributos graváveis ou em zero caso contrário. Também retornará zero se pWritableAttrs for NULL.

Comentários

Durante a inicialização, uma extensão de folha de propriedades deve determinar se os atributos que ela pode alterar podem ser gravados usando ADsPropCheckIfWritable. Se um atributo não puder ser gravado, ele deverá ser exibido como somente leitura e a capacidade de alterar o valor do atributo deverá ser removida.

É possível que um usuário tenha permissão de gravação, mas não permissão de leitura para um atributo. Nesse caso, a operação de leitura do atributo falha e é possível que o atributo possa ser substituído. Consequentemente, não é recomendável conceder a permissão de gravação de um usuário, mas revogar a permissão de leitura em um atributo.

Não use essa função para verificar a permissão de gravação para atributos em uma folha de propriedades de seleção múltipla. É provável que cada objeto de diretório tenha um conjunto diferente de permissões de atributo graváveis. A extensão da folha de propriedades deve depender do servidor que retorna um erro ao tentar gravar em um objeto específico em um grupo selecionado para determinar se as permissões de gravação para esse objeto são negadas.

Requisitos

Confira também

ADS_ATTR_INFO

ADsPropGetInitInfo