Método IADsSecurityUtility::GetSecurityDescriptor (iads.h)

Artigo
03/05/2024

O método GetSecurityDescriptor recupera um descritor de segurança para o arquivo, o compartilhamento de arquivos ou a chave do Registro especificados.

Sintaxe

HRESULT GetSecurityDescriptor(
  [in]  VARIANT varPath,
  [in]  long    lPathFormat,
  [in]  long    lFormat,
  [out] VARIANT *pVariant
);

Parâmetros

[in] varPath

Uma cadeia de caracteres VARIANT que contém o caminho do objeto para o qual recuperar o descritor de segurança.

Arquivo

Uma sintaxe de caminho de arquivo válida. Por exemplo: "c:\specs\public\adxml.doc" ou "\adsi\public\dsclient.exe".

Uma sintaxe de caminho de arquivo válida para um compartilhamento de arquivos. Por exemplo: "\adsi\public".

Chave do Registro

Uma sintaxe válida do Registro. Por exemplo, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".

[in] lPathFormat

Contém um dos valores ADS_PATHTYPE_ENUM que especifica o formato do parâmetro varPath .

[in] lFormat

Contém um dos valores ADS_SD_FORMAT_ENUM que especifica o formato do descritor de segurança retornado no parâmetro pVariant . A lista a seguir identifica os valores possíveis para esse parâmetro e o formato fornecido no parâmetro pVariant .

ADS_SD_FORMAT_IID

pVariant recebe uma VT_DISPATCH que pode ser consultada para a interface IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

pVariant 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

pVariant recebe um VT_BSTR que contém o descritor de segurança bruto no formato de cadeia de caracteres de codificação hex.

[out] pVariant

Ponteiro para um VARIANT que recebe o descritor de segurança retornado. O formato do descritor de segurança recuperado é especificado pelo parâmetro lFormat .

Retornar valor

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

Requisito	Valor
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