Valeurs de retour de la gestion de la sécurité

  • Article

Les valeurs de retour de la gestion de la sécurité sont les suivantes :

Valeurs de retour des pièces jointes

L’ensemble d’outils Configuration de la sécurité prend en charge les codes de retour SCESTATUS suivants. Ces valeurs sont retournées par les fonctions de prise en charge des pièces jointes et celles implémentées lors de l’écriture d’un moteur de pièce jointe ou d’un composant logiciel enfichable.

Valeur Description
SCESTATUS_SUCCESS La fonction a réussi.
SCESTATUS_INVALID_PARAMETER L’un des paramètres passés à la fonction n’était pas valide.
SCESTATUS_RECORD_NOT_FOUND L’enregistrement spécifié est introuvable dans la base de données de sécurité.
SCESTATUS_INVALID_DATA La fonction a échoué, car certaines données n’étaient pas valides.
SCESTATUS_OBJECT_EXISTS L'objet existe déjà.
SCESTATUS_BUFFER_TOO_SMALL La mémoire tampon passée dans la fonction pour recevoir des données n’est pas assez grande pour recevoir toutes les données.
SCESTATUS_PROFILE_NOT_FOUND Le profil spécifié est introuvable.
SCESTATUS_BAD_FORMAT Le format n’est pas valide.
SCESTATUS_NOT_ENOUGH_RESOURCE La mémoire est insuffisante.
SCESTATUS_ACCESS_DENIED L’appelant ne dispose pas des privilèges suffisants pour effectuer cette action.
SCESTATUS_CANT_DELETE La fonction ne peut pas supprimer l’élément spécifié.
SCESTATUS_PREFIX_OVERFLOW Un dépassement de préfixe s’est produit.
SCESTATUS_OTHER_ERROR Une erreur inconnue s’est produite.
SCESTATUS_ALREADY_RUNNING Le service est déjà en cours d'exécution.
SCESTATUS_SERVICE_NOT_SUPPORT Le service spécifié n’est pas pris en charge.
SCESTATUS_MOD_NOT_FOUND Une DLL du moteur de pièces jointes répertoriée dans le Registre est introuvable ou ne peut pas être chargée.
SCESTATUS_EXCEPTION_IN_SERVER Une exception s’est produite sur le serveur.

Valeurs de retour de la fonction de stratégie LSA

La plupart des fonctions de stratégie d’autorité de sécurité locale (LSA) retournent une valeur NTSTATUS pour indiquer la réussite ou l’échec. Les différentes valeurs NTSTATUS sont définies dans Ntstatus.h, qui est distribué avec le Kit de développement du pilote Microsoft Windows (DDK).

Pour convertir une valeur de retour NTSTATUS en code d’erreur Windows, utilisez la fonction LsaNtStatusToWinError .

Le tableau suivant répertorie les valeurs NTSTATUS qui peuvent être retournées par n’importe quelle fonction LSA. (Les sections de valeur de retour pour certaines fonctions LSA répertorient les codes d’erreur supplémentaires que la fonction peut retourner.) Ce tableau répertorie également le code d’erreur Windows qui correspond à chaque valeur NTSTATUS.

Code NTSTATUS (code d’erreur Windows) Signification
STATUS_SUCCESS (ERROR_SUCCESS)
 La fonction a réussi.
STATUS_ACCESS_DENIED (ERROR_ACCESS_DENIED)
 L’appelant ne dispose pas de l’accès approprié pour terminer l’opération.
STATUS_INSUFFICIENT_RESOURCES (ERROR_NO_SYSTEM_RESOURCES)
 Il n’y a pas suffisamment de ressources système (telles que la mémoire pour allouer des mémoires tampons) pour terminer l’appel.
STATUS_INTERNAL_DB_ERROR (ERROR_INTERNAL_DB_ERROR)
 La base de données LSA contient une incohérence interne.
STATUS_INVALID_HANDLE (ERROR_INVALID_HANDLE)
 Indique qu’un objet ou un handle RPC n’est pas valide dans le contexte utilisé.
STATUS_INVALID_SERVER_STATE (ERROR_INVALID_SERVER_STATE)
 Indique que le serveur LSA est actuellement désactivé.
STATUS_INVALID_PARAMETER (ERROR_INVALID_PARAMETER)
 L’un des paramètres n’est pas valide.
STATUS_NO_SUCH_PRIVILEGE (ERROR_NO_SUCH_PRIVILEGE)
 Indique qu’aucun privilège spécifié n’existe.
STATUS_OBJECT_NAME_NOT_FOUND (ERROR_FILE_NOT_FOUND)
 Un objet dans la base de données de stratégie LSA est introuvable. L’objet a peut-être été spécifié par SID ou par nom, en fonction de son type.
STATUS_UNSUCCESSFUL (ERROR_GEN_FAILURE)
 Échec générique, tel qu’un échec de connexion RPC.