Função BinarySDToSecurityDescriptor (adshlp.h)

Artigo
02/26/2024

A função BinarySDToSecurityDescriptor converte um descritor de segurança binário 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 essa 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.

Retornar valor

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.

Comentários

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	adshlp.h
Biblioteca	Activeds.lib
DLL	Activeds.dll