Método IADsSecurityUtility::GetSecurityDescriptor (iads.h)
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".
Compartilhamento de arquivo
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 |