Funzione ConvertSecurityDescriptorToStringSecurityDescriptorA (sddl.h)

Articolo
11/20/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 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ò trovarsi in formato assoluto o auto-relativo.

[in] RequestedStringSDRevision

Specifica il livello di revisione dell'output stringa StringSecurityDescriptor. 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 di stringa null.

[out] StringSecurityDescriptor

Puntatore a una variabile che riceve un puntatore a un nullstringa del descrittore di sicurezza con terminazione. Per una descrizione del formato stringa, vedere 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 StringSecurityDescript or. Questo parametro può essere NULL se non è necessario recuperare le dimensioni. La dimensione rappresenta le dimensioni del buffer in WCHARs, non il numero di WCHARnella 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 ottenere informazioni estese sull'errore, chiamare GetLastError. La funzione GetLastError può restituire uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Parametro non valido.
ERROR_UNKNOWN_REVISION	Il livello di revisione non è valido.
ERROR_NONE_MAPPED	Impossibile trovare un identificatore 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 di controllo di accesso viene NULL.

Osservazioni

Se l'elenco DACL è NULLe il bit di controllo SE_DACL_PRESENT viene impostato nel descrittore di sicurezza di input, la funzione non riesce.

Se l'elenco DACL è NULLe il bit di controllo SE_DACL_PRESENT non è impostato nel descrittore di sicurezza di input, la stringa del descrittore di sicurezza risultante non dispone di un componente D: . Per altre informazioni, vedere Formato stringa descrittore di sicurezza.

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	sddl.h
libreria	Advapi32.lib
dll	Advapi32.dll