Compartir a través de

Función FwpmGetAppIdFromFileName0 (fwpmu.h)

  • Artículo

La función FwpmGetAppIdFromFileName0 recupera un identificador de aplicación de un nombre de archivo.

Sintaxis

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

Parámetros

[in] fileName

Tipo: const wchar_t*

Nombre de archivo desde el que se recuperará el identificador de la aplicación.

[out] appId

Tipo: FWP_BYTE_BLOB**

Identificador de aplicación recuperado.

Valor devuelto

Tipo: DWORD

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 El identificador de aplicación se recuperó correctamente.
código de error FWP_E_*
0x80320001: 0x80320039
 Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información.
RPC_* código de error*
0x80010001: 0x80010122
 Error al comunicarse con el motor de firewall remoto o local.

Comentarios

El autor de la llamada debe liberar el objeto devuelto por una llamada a FwpmFreeMemory0.

FwpmGetAppIdFromFileName0 es una implementación específica de FwpmGetAppIdFromFileName. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

Ejemplos

En el ejemplo de C++ siguiente se muestra cómo recuperar un identificador de aplicación mediante 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 Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll

Consulte también

FWP_BYTE_BLOB