Funzione ConvertSecurityDescriptorToStringSecurityDescriptorA (sddl.h)

Articolo
03/05/2024

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