Método IADsSecurityUtility::ConvertSecurityDescriptor (iads.h)
O método ConvertSecurityDescriptor converte um descritor de segurança de um formato para outro.
Sintaxe
HRESULT ConvertSecurityDescriptor(
[in] VARIANT varSD,
[in] long lDataFormat,
[in] long lOutFormat,
[out] VARIANT *pResult
);
Parâmetros
[in] varSD
Uma VARIANT que contém o descritor de segurança a ser convertido. O formato dessa VARIANT é definido pelo parâmetro lDataFormat .
[in] lDataFormat
Contém um dos valores ADS_SD_FORMAT_ENUM que especifica o formato do descritor de segurança no parâmetro varSD . A lista a seguir identifica os valores possíveis para esse parâmetro e o formato do parâmetro varSD .
ADS_SD_FORMAT_IID
varSD contém um VT_DISPATCH que pode ser consultado para a interface IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
varSD contém um VT_I1 | VT_ARRAY que contém o descritor de segurança no formato de dados brutos. Isso está no formato de uma estrutura de SECURITY_DESCRIPTOR .
ADS_SD_FORMAT_HEXSTRING
varSD contém um VT_BSTR que contém o descritor de segurança bruto no formato de cadeia de caracteres de codificação hex.
[in] lOutFormat
Contém um dos valores ADS_SD_FORMAT_ENUM que especifica o formato no qual o descritor de segurança deve ser convertido. A lista a seguir identifica os valores possíveis para esse parâmetro e o formato do parâmetro pvResult .
ADS_SD_FORMAT_IID
pvResult recebe uma VT_DISPATCH que pode ser consultada para a interface IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
pvResult recebe um VT_I1 | VT_ARRAY que contém o descritor de segurança no formato de dados brutos. Isso está no formato de uma estrutura de SECURITY_DESCRIPTOR .
ADS_SD_FORMAT_HEXSTRING
pvResult recebe um VT_BSTR que contém o descritor de segurança bruto no formato de cadeia de caracteres de codificação hex.
[out] pResult
Ponteiro para um VARIANT que recebe o descritor de segurança convertido. O formato do descritor de segurança recuperado é especificado pelo parâmetro lOutFormat .
Valor retornado
Retorna S_OK se tiver êxito ou um código de erro COM ou Win32, caso contrário. Os códigos de erro possíveis incluem o seguinte.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | iads.h |
| DLL | Activeds.dll |