Fonction InitializeSecurityDescriptor (securitybaseapi.h)
La fonction InitializeSecurityDescriptor initialise un nouveau descripteur de sécurité.
Syntaxe
BOOL InitializeSecurityDescriptor(
[out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] DWORD dwRevision
);
Paramètres
[out] pSecurityDescriptor
Pointeur vers une structure SECURITY_DESCRIPTOR que la fonction initialise.
[in] dwRevision
Niveau de révision à affecter au descripteur de sécurité. Ce paramètre doit être SECURITY_DESCRIPTOR_REVISION.
Valeur retournée
Si la fonction réussit, la fonction retourne une valeur différente de zéro.
Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
La fonction InitializeSecurityDescriptor initialise un descripteur de sécurité au format absolu , plutôt qu’au format auto-relatif .
La fonction InitializeSecurityDescriptor initialise un descripteur de sécurité pour n’avoir aucune liste de contrôle d’accès système (SACL), aucune liste de contrôle d’accès discrétionnaire (DACL), aucun propriétaire, aucun groupe principal et tous les indicateurs de contrôle définis sur FALSE (NULL). Ainsi, à l’exception de son niveau de révision, il est vide.
Exemples
Pour obtenir un exemple qui utilise cette fonction, consultez Création d’un descripteur de sécurité pour un nouvel objet.
Spécifications
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | securitybaseapi.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |