Fonction FwpmGetAppIdFromFileName0 (fwpmu.h)
La fonction FwpmGetAppIdFromFileName0 récupère un identificateur d’application à partir d’un nom de fichier.
Syntaxe
DWORD FwpmGetAppIdFromFileName0(
[in] PCWSTR fileName,
[out] FWP_BYTE_BLOB **appId
);
Paramètres
[in] fileName
Type : const wchar_t*
Nom de fichier à partir duquel l’identificateur d’application sera récupéré.
[out] appId
Type : FWP_BYTE_BLOB**
Identificateur d’application récupéré.
Valeur retournée
Type : DWORD
Code/valeur de retour | Description |
---|---|
|
L’identificateur de l’application a été récupéré avec succès. |
|
Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM . |
|
Échec de la communication avec le moteur de pare-feu distant ou local. |
Remarques
L’appelant doit libérer l’objet retourné par un appel à FwpmFreeMemory0.
FwpmGetAppIdFromFileName0 est une implémentation spécifique de FwpmGetAppIdFromFileName. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
Exemples
L’exemple C++ suivant montre comment récupérer un identificateur d’application à l’aide de FwpmGetAppIdFromFileName0.
#include <windows.h>
#include <fwpmu.h>
#include <stdio.h>
#pragma comment(lib, "Fwpuclnt.lib")
// Hard-coded file name for demonstration purposes.
#define FILE_PATH1 L"C:\\Program Files\\SomeAppFolder\\SomeApplication.exe"
int main()
{
DWORD result = ERROR_SUCCESS;
FWP_BYTE_BLOB *fwpApplicationByteBlob = NULL;
printf("Retrieving Id for application to allow through firewall.\n");
result = FwpmGetAppIdFromFileName0(FILE_PATH1, &fwpApplicationByteBlob);
if (result != ERROR_SUCCESS)
{
printf("FwpmGetAppIdFromFileName failed (%d).\n", result);
return result;
}
else
{
printf("The Id is: %d\n", fwpApplicationByteBlob->data);
}
return 0;
}
// ----------------------------------------------------------------------
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | fwpmu.h |
Bibliothèque | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |