Metodo IADsSecurityUtility::ConvertSecurityDescriptor (iads.h)
Il metodo ConvertSecurityDescriptor converte un descrittore di sicurezza da un formato a un altro.
Sintassi
HRESULT ConvertSecurityDescriptor(
[in] VARIANT varSD,
[in] long lDataFormat,
[in] long lOutFormat,
[out] VARIANT *pResult
);
Parametri
[in] varSD
VARIANT che contiene il descrittore di sicurezza da convertire. Il formato di questo VARIANT è definito dal parametro lDataFormat .
[in] lDataFormat
Contiene uno dei valori ADS_SD_FORMAT_ENUM che specifica il formato del descrittore di sicurezza nel parametro varSD . L'elenco seguente identifica i valori possibili per questo parametro e il formato del parametro varSD .
ADS_SD_FORMAT_IID
varSD contiene un VT_DISPATCH che può essere sottoposto a query per l'interfaccia IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
varSD contiene un VT_I1 VT_ARRAY | contenente il descrittore di sicurezza in formato dati non elaborato. Si tratta del formato di una struttura SECURITY_DESCRIPTOR .
ADS_SD_FORMAT_HEXSTRING
varSD contiene un VT_BSTR che contiene il descrittore di sicurezza non elaborato in formato stringa con codifica esadecimale.
[in] lOutFormat
Contiene uno dei valori ADS_SD_FORMAT_ENUM che specifica il formato in cui deve essere convertito il descrittore di sicurezza. L'elenco seguente identifica i valori possibili per questo parametro e il formato del parametro pvResult .
ADS_SD_FORMAT_IID
pvResult riceve un VT_DISPATCH che può essere sottoposto a query per l'interfaccia IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
pvResult riceve un VT_I1 VT_ARRAY | contenente il descrittore di sicurezza in formato dati non elaborato. Si tratta del formato di una struttura SECURITY_DESCRIPTOR .
ADS_SD_FORMAT_HEXSTRING
pvResult riceve un VT_BSTR che contiene il descrittore di sicurezza non elaborato in formato stringa con codifica hex.
[out] pResult
Puntatore a un valore VARIANT che riceve il descrittore di sicurezza convertito. Il formato del descrittore di sicurezza recuperato viene specificato dal parametro lOutFormat .
Valore restituito
Restituisce S_OK se ha esito positivo o un codice di errore COM o Win32 in caso contrario. I codici di errore possibili includono quanto segue.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | iads.h |
| DLL | Activeds.dll |