Partager via

SaferGetLevelInformation, fonction (winsafer.h)

  • Article

La fonction SaferGetLevelInformation récupère des informations sur un niveau de stratégie.

Syntaxe

BOOL SaferGetLevelInformation(
  [in]            SAFER_LEVEL_HANDLE      LevelHandle,
  [in]            SAFER_OBJECT_INFO_CLASS dwInfoType,
  [out, optional] LPVOID                  lpQueryBuffer,
  [in]            DWORD                   dwInBufferSize,
  [out]           LPDWORD                 lpdwOutBufferSize
);

Paramètres

[in] LevelHandle

Handle du niveau à interroger.

[in] dwInfoType

Valeur d’énumération SAFER_OBJECT_INFO_CLASS qui spécifie le type d’informations d’objet à retourner. La valeur spécifiée détermine la taille et le type du paramètre lpQueryBuffer . Le tableau suivant répertorie les valeurs possibles.

Value Signification
SaferObjectLevelId
1
 Requêtes pour la constante LEVELID.

Type de retour lpQueryBuffer : DWORD.
SaferObjectScopeId
2
 Requêtes pour l’étendue de l’utilisateur ou de l’ordinateur.

Type de retour lpQueryBuffer : DWORD.
SaferObjectFriendlyName
3
 Requêtes pour le nom complet.

Type de retour lpQueryBuffer : LPCWSTR.
SaferObjectDescription
4
 Requêtes pour la description.

Type de retour lpQueryBuffer : LPCWSTR.

[out, optional] lpQueryBuffer

Mémoire tampon pour contenir les résultats de la requête. Pour connaître le type des informations retournées pour chaque valeur possible du paramètre dwInfoType , consultez le paramètre dwInfoType .

[in] dwInBufferSize

Taille du paramètre lpQueryBuffer en octets.

[out] lpdwOutBufferSize

Pointeur pour retourner la taille de sortie du paramètre lpQueryBuffer .

Valeur retournée

TRUE si la fonction réussit ; sinon, FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winsafer.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll
Ensemble d’API ext-ms-win-advapi32-safer-l1-1-0 (introduit dans Windows 8)