Поделиться через

Функция FwpmGetAppIdFromFileName0 (fwpmu.h)

  • Статья

Функция FwpmGetAppIdFromFileName0 извлекает идентификатор приложения из имени файла.

Синтаксис

DWORD FwpmGetAppIdFromFileName0(
  [in]  PCWSTR        fileName,
  [out] FWP_BYTE_BLOB **appId
);

Параметры

[in] fileName

Тип: const wchar_t*

Имя файла, из которого будет получен идентификатор приложения.

[out] appId

Тип: FWP_BYTE_BLOB**

Полученный идентификатор приложения.

Возвращаемое значение

Тип: DWORD

Возвращаемый код/значение Описание
ERROR_SUCCESS
0
 Идентификатор приложения успешно получен.
Код ошибки FWP_E_*
0x80320001 — 0x80320039
 Ошибка, определяемая платформой фильтрации Windows (WFP). Дополнительные сведения см. в разделе Коды ошибок ВПП .
Код ошибки RPC_*
0x80010001 — 0x80010122
 Сбой связи с подсистемой удаленного или локального брандмауэра.

Комментарии

Вызывающий объект должен освободить возвращенный объект путем вызова FwpmFreeMemory0.

FwpmGetAppIdFromFileName0 — это конкретная реализация FwpmGetAppIdFromFileName. Дополнительные сведения см. в разделах ИМЕНА Version-Independent ВПП и Выбор конкретных версий Windows .

Примеры

В следующем примере C++ показано, как получить идентификатор приложения с помощью 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;
}
// ----------------------------------------------------------------------

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll

См. также раздел

FWP_BYTE_BLOB