Funzione BinarySDToSecurityDescriptor (adshlp.h)

Articolo
02/26/2024

La funzione BinarySDToSecurityDescriptor converte un descrittore di sicurezza binario in un oggetto IADsSecurityDescriptor .

Sintassi

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parametri

[in] pSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR

Indirizzo di una struttura SECURITY_DESCRIPTOR da convertire.

[out] pVarsec

Tipo: VARIANT*

Indirizzo di un valore VARIANT che riceve l'oggetto . VARIANT contiene un oggetto VT_DISPATCH su cui è possibile eseguire query per l'interfaccia IADsSecurityDescriptor. Il chiamante deve rilasciare questo valore VARIANT passando variant alla funzione VariantClear.

[in] pszServerName

Tipo: LPCWSTR

Stringa Unicode con terminazione Null che fornisce il nome del server da cui è stato recuperato il descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] userName

Tipo: LPCWSTR

Stringa Unicode con terminazione Null che fornisce il nome utente da associare al descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] passWord

Tipo: LPCWSTR

Stringa Unicode con terminazione Null che fornisce la password da associare al descrittore di sicurezza. Questo parametro è facoltativo e può essere NULL.

[in] dwFlags

Tipo: DWORD

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

Valore restituito

Tipo: HRESULT

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

Se l'operazione non riesce, viene restituito un codice di errore ADSI. Per altre informazioni, vedere Codici di errore ADSI.

Commenti

Questa funzione viene usata per le applicazioni legacy che devono convertire manualmente i descrittori di sicurezza in descrittori di sicurezza binari. Per le nuove applicazioni, usare l'interfaccia 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