Função FwpmGetAppIdFromFileName0 (fwpmu.h)
A função FwpmGetAppIdFromFileName0 recupera um identificador de aplicativo de um nome de arquivo.
Sintaxe
DWORD FwpmGetAppIdFromFileName0(
[in] PCWSTR fileName,
[out] FWP_BYTE_BLOB **appId
);
Parâmetros
[in] fileName
Tipo: const wchar_t*
Nome do arquivo do qual o identificador do aplicativo será recuperado.
[out] appId
Tipo: FWP_BYTE_BLOB**
O identificador de aplicativo recuperado.
Retornar valor
Tipo: DWORD
Valor/código retornado | Descrição |
---|---|
|
O identificador do aplicativo foi recuperado com êxito. |
|
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes. |
|
Falha ao se comunicar com o mecanismo de firewall remoto ou local. |
Comentários
O chamador deve liberar o objeto retornado por uma chamada para FwpmFreeMemory0.
FwpmGetAppIdFromFileName0 é uma implementação específica de FwpmGetAppIdFromFileName. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
Exemplos
O exemplo C++ a seguir mostra como recuperar um identificador de aplicativo usando 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;
}
// ----------------------------------------------------------------------
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | fwpmu.h |
Biblioteca | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |