Função BinarySDToSecurityDescriptor (adshlp.h)

A função BinarySDToSecurityDescriptor converte um descritor de segurança binária em um objeto IADsSecurityDescriptor.

Sintaxe

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parâmetros

[in] pSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR

Endereço de uma estrutura SECURITY_DESCRIPTOR a ser convertida.

[out] pVarsec

Tipo: VARIANT*

Endereço de um VARIANT que recebe o objeto. O VARIANT contém um objeto VT_DISPATCH que pode ser consultado para a interface IADsSecurityDescriptor. O chamador deve liberar este VARIANT passando o VARIANT para a função VariantClear.

[in] pszServerName

Tipo: LPCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que fornece o nome do servidor do qual o descritor de segurança foi recuperado. Esse parâmetro é opcional e pode ser NULL.

[in] userName

Tipo: LPCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que fornece o nome de usuário a ser associado ao descritor de segurança. Esse parâmetro é opcional e pode ser NULL.

[in] passWord

Tipo: LPCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que fornece a senha a ser associada ao descritor de segurança. Esse parâmetro é opcional e pode ser NULL.

[in] dwFlags

Tipo: DWORD

Contém sinalizadores de autenticação para a conversão. Isso pode ser zero ou uma combinação de um ou mais dos valores de enumeração ADS_AUTHENTICATION_ENUM.

Valor de retorno

Tipo: HRESULT

Esse método dá suporte a valores retornados padrão, bem como o seguinte:

Se a operação falhar, um código de erro ADSI será retornado. Para obter mais informações, consulte códigos de erro ADSI.

Observações

Essa função é usada para aplicativos herdados que devem converter manualmente descritores de segurança em descritores de segurança binários. Para novos aplicativos, use a interface IADsSecurityUtility, que faz essa conversão automaticamente.

Requisitos

Consulte também

códigos de erro ADSI

Funções ADSI

ADS_AUTHENTICATION_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

securityDescriptorToBinarySD

VariantClear