Função SecurityDescriptorToBinarySD (adshlp.h)

Artigo
03/13/2024

A função SecurityDescriptorToBinarySD converte um objeto IADsSecurityDescriptor no formato de descritor de segurança binário.

Sintaxe

HRESULT SecurityDescriptorToBinarySD(
  [in]  VARIANT              vVarSecDes,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] PDWORD               pdwSDLength,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parâmetros

[in] vVarSecDes

Tipo: VARIANT

Contém um VARIANT que contém o descritor de segurança a ser convertido. O VARIANT deve conter um VT_DISPATCH que contém um objeto IADsSecurityDescriptor .

[out] ppSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

Endereço de um ponteiro SECURITY_DESCRIPTOR que recebe os dados do descritor de segurança binário. O chamador deve liberar essa memória passando esse ponteiro para a função FreeADsMem .

[out] pdwSDLength

Tipo: PDWORD

Endereço de um valor DWORD que recebe o comprimento, em bytes dos dados do descritor de segurança binário.

[in] pszServerName

Tipo: LPCWSTR

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

[in] userName

Tipo: LPCWSTR

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

[in] passWord

Tipo: LPCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém a senha que o descritor de segurança está associado. 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 aos valores retornados padrão, bem como aos seguintes.

Comentários

Essa função é usada para aplicativos herdados converterem manualmente descritores de segurança em descritores de segurança binários. Para novos aplicativos, use IADsSecurityUtility, que executa 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