Condividi tramite


Funzione ConvertSecurityDescriptorToStringSecurityDescriptorA (sddl.h)

La funzione ConvertSecurityDescriptorToStringSecurityDescriptor converte un descrittore di sicurezza in un formato stringa. È possibile usare il formato stringa per archiviare o trasmettere il descrittore di sicurezza.

Per convertire di nuovo il descrittore di sicurezza in formato stringa in un descrittore di sicurezza funzionale valido, chiamare la funzione ConvertStringSecurityDescriptorToSecurityDescriptor .

Sintassi

BOOL ConvertSecurityDescriptorToStringSecurityDescriptorA(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  DWORD                RequestedStringSDRevision,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] LPSTR                *StringSecurityDescriptor,
  [out] PULONG               StringSecurityDescriptorLen
);

Parametri

[in] SecurityDescriptor

Puntatore al descrittore di sicurezza da convertire. Il descrittore di sicurezza può essere in formato assoluto o auto-relativo.

[in] RequestedStringSDRevision

Specifica il livello di revisione della stringa StringSecurityDescriptor di output. Attualmente questo valore deve essere SDDL_REVISION_1.

[in] SecurityInformation

Specifica una combinazione dei flag di bit SECURITY_INFORMATION per indicare i componenti del descrittore di sicurezza da includere nella stringa di output.

Il flag BACKUP_SECURITY_INFORMATION non è applicabile a questa funzione. Se il flag BACKUP_SECURITY_INFORMATION viene passato, il parametro SecurityInformation restituisce TRUE con output stringa Null .

[out] StringSecurityDescriptor

Puntatore a una variabile che riceve un puntatore a una stringa del descrittore di sicurezza con terminazione Null. Per una descrizione del formato stringa, vedere Security Descriptor String Format.For a description of the string format, see Security Descriptor String Format. Per liberare il buffer restituito, chiamare la funzione LocalFree .

[out] StringSecurityDescriptorLen

Puntatore a una variabile che riceve le dimensioni, in TCHARs, della stringa del descrittore di sicurezza restituita nel buffer StringSecurityDescriptor . Questo parametro può essere NULL se non è necessario recuperare le dimensioni. La dimensione rappresenta le dimensioni del buffer in WCHARs, non il numero di WCHARs nella stringa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. La funzione GetLastError può restituire uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
Un parametro non è valido.
ERROR_UNKNOWN_REVISION
Il livello di revisione non è valido.
ERROR_NONE_MAPPED
Non è stato possibile trovare un ID di sicurezza (SID) nel descrittore di sicurezza di input in un'operazione di ricerca dell'account.
ERROR_INVALID_ACL
L'elenco di controllo di accesso (ACL) non è valido. Questo errore viene restituito se il flag SE_DACL_PRESENT è impostato nel descrittore di sicurezza di input e l'elenco DACL è NULL.

Commenti

Se l'elenco DACL è NULL e il bit di controllo SE_DACL_PRESENT è impostato nel descrittore di sicurezza di input, la funzione ha esito negativo.

Se l'oggetto DACL è NULL e il bit di controllo SE_DACL_PRESENT non è impostato nel descrittore di sicurezza di input, la stringa del descrittore di sicurezza risultante non ha un componente D: . Per altre informazioni, vedere Security Descriptor String Format.For more information, see Security Descriptor String Format.

Nota

L'intestazione sddl.h definisce ConvertSecurityDescriptorToStringSecurityDescriptor come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione sddl.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

Panoramica di Controllo di accesso

Funzioni Controllo di accesso di base

ConvertSidToStringSid

ConvertStringSecurityDescriptorToSecurityDescriptor

ConvertStringSidToSid

SECURITY_DESCRIPTOR

SECURITY_INFORMATION