Valeurs de retour de la gestion de la sécurité
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. |