SaferGetLevelInformation, fonction (winsafer.h)

Article
03/06/2024

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)

Partager via