Funzione SecurityDescriptorToBinarySD (adshlp.h)

Articolo
08/22/2023

La funzione SecurityDescriptorToBinarySD converte un oggetto IADsSecurityDescriptor nel formato descrittore di sicurezza binario.

Sintassi

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

Parametri

[in] vVarSecDes

Tipo: VARIANT

Contiene un valore VARIANT che contiene il descrittore di sicurezza da convertire. VARIANT deve contenere un VT_DISPATCH che contiene un oggetto IADsSecurityDescriptor.

[out] ppSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

Indirizzo di un puntatore SECURITY_DESCRIPTOR che riceve i dati del descrittore di sicurezza binaria. Il chiamante deve liberare questa memoria passando questo puntatore alla funzione FreeADsMem .

[out] pdwSDLength

Tipo: PDWORD

Indirizzo di un valore DWORD che riceve la lunghezza, in byte dei dati di sicurezza binaria.

[in] pszServerName

Tipo: LPCWSTR

Stringa Unicode con terminazione null che specifica il nome del server in cui viene inserito il descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] userName

Tipo: LPCWSTR

Stringa Unicode con terminazione null contenente il nome utente a cui è associato il descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] passWord

Tipo: LPCWSTR

Stringa Unicode con terminazione null contenente la password associata al descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] dwFlags

Tipo: DWORD

Contiene i flag di autenticazione per la conversione. Questo può essere zero o una combinazione di uno o più dei valori di enumerazione ADS_AUTHENTICATION_ENUM .

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti standard, nonché i seguenti.

Commenti

Questa funzione viene usata per le applicazioni legacy per convertire manualmente i descrittori di sicurezza in descrittori di sicurezza binari. Per le nuove applicazioni, usare IADsSecurityUtility, che esegue automaticamente questa conversione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	adshlp.h
Libreria	Activeds.lib
DLL	Activeds.dll